| Line | Revision | Contents |
| 1 | 20 | FSPv2 -> HTTP/1.1 protocol proxy |
| 2 | Radim Kolar | |
| 3 | 2003-9 | |
| 4 | http://fsp.sourceforge.net/fsproxy.html | |
| 5 | This software is part of FSP project | |
| 6 | 9 | |
| 7 | 6 | Copyright: |
| 8 | You may copy or modify this file in any manner you wish, provided | |
| 9 | that this notice is always included, and that you hold the author | |
| 10 | harmless for any loss or damage resulting from the installation or | |
| 11 | use of this software. | |
| 12 | ||
| 13 | Summary: | |
| 14 | 9 | This proxy supports HTTP/1.1 on output side and FSP v2 on input side. |
| 15 | FSP v2 over HTTP/1.1. This proxy do not caches anything. | |
| 16 | 6 | |
| 17 | 8 | In detail: |
| 18 | Using this proxy, you can browse FSP sites by any web browser | |
| 19 | 20 | which support gopher protocol. |
| 20 | This proxy DOES NOT tunnels HTTP over FSP. This is a different project. | |
| 21 | 8 | |
| 22 | 6 | Installation: |
| 23 | 8 | |
| 24 | 9 | 1. Get FSP protocol stack for Java - fsp javalib |
| 25 | 8 | |
| 26 | 9 | This program needs correctly installed (in CLASSPATH) jfsplib, |
| 27 | 8 | you can get it from main FSP protocol suite site: |
| 28 | http://fsp.sourceforge.net/javalib.html | |
| 29 | 27 | You need at least 1.0rc7 version of jfsplib |
| 30 | 6 | |
| 31 | 8 | 2. Setup WWW browser's proxy |
| 32 | 6 | Setup Gopher proxy in web browser to port 9090 on host which is running |
| 33 | fsproxy. | |
| 34 | ||
| 35 | 8 | 3. Run fsp proxy daemon |
| 36 | ||
| 37 | 31 | distributed fsproxy.jar is autostartable, but there seems to be problem |
| 38 | that java launcher (tested on 1.6.0_16) is unable to merge classpath with | |
| 39 | autostartable jar content. | |
| 40 | ||
| 41 | 6 | Running: |
| 42 | 31 | Usage: java -cp fsproxy-0.X.jar;jfsplib-1.0rc8.jar fspproxy [portnumber] [mime type table] |
| 43 | ||
| 44 | Note: Unix systems are using : instead of ; as classpath separator | |
| 45 | 8 | |
| 46 | FSP proxy can load mime.types style file for mapping file extensions | |
| 47 | to mime types. You can get this file from apache httpd distribution. | |
| 48 | ||
| 49 | 31 | Examples: |
| 50 | Unix | |
| 51 | java -cp jfsplib-1.0rc8.jar:fsproxy-0.8.jar 9090 /usr/local/etc/mime.types | |
| 52 | 6 | |
| 53 | 31 | Windows |
| 54 | C:\target>java -cp jfsplib-1.0rc8.jar;fsproxy-0.8.jar fspproxy | |
| 55 | Fri Oct 30 13:48:08 CET 2009 FSP Proxy 0.8 ready on 9090/* | |
| 56 | 9 | |
| 57 | 6 | Operation: |
| 58 | 8 | |
| 59 | 10 | FSP Proxy runs on port by default 9090 and accepts fsp://*, http://*, ftp://* |
| 60 | 20 | and gopher://* URLs on input side. These requests are transformed info FSP v2 |
| 61 | 9 | requests and sent to the target FSP server. Most browser do not recognize |
| 62 | fsp:// urls, so you have to type gopher: instead of fsp: | |
| 63 | 8 | |
| 64 | 20 | Simply type in your browser URL bar 'gopher://your.favourite.fsp.site/' without |
| 65 | quotes and begin to browse content of particular FSP site. | |
| 66 | 9 | In most cases you must use port number as part of URL: |
| 67 | gopher://your.favourite.fsp.site:2000/ | |
| 68 | ||
| 69 | 20 | Directory listing is pretty fast, isn't it? |
| 70 | 8 | |
| 71 | 20 | ********************************************** |
| 72 | This is a free software. Be creative. | |
| 73 | Let me know of any bugs and suggestions. | |
| 74 | 31 | ************************* |
| 75 | 6 | |
| 76 | Radim Kolar | |
| 77 | 8 | hsn@users.sourceforge.net |
| 78 | 31 | Main developer of FSP project |
Loggerhead is a web-based interface for Bazaar branches