Thanks for downloading URLFetch. We hope you find it useful. The zipped file you just retrieved may be found by visiting http://www.screen-scraper.com/urlfetch/download.shtml. You can view documentation for URLFetch at http://www.screen-scraper.com/urlfetch/doc.shtml. Feel free to send any comments or suggestions to info@screen-scraper.com. If you make any enhancements to URLFetch by modifying the source code and recompiling we'd appreciate receiving a copy so that we can post it for other people to use. Also, please take a look at the LICENSE and DISCLAIMER sections of this document if you'd like to work with the source code. WHAT'S IN THE ZIP FILE --------------------------- - URLFetch.class, URLFetch$1.class, URLFetch$ConnectThread.class, URLFetch$ContentReceivedThread.class, URLFetch$TimeoutThread.class (the Java class files that encapsulates the URLFetch functionality) - URLFetch.dll (the DLL wrapper that allows URLFetch to be used as an ActiveX component) - readme.txt (the file you're now reading) - URLFetch.java (file containing the Java source code for URLFetch) - URLFetch.sln, URLFetch.suo, URLFetch.tlb, URLFetch.vbr, URLFetch.vjp, codebase.dat (various files used by Visual J++; URLFetch.vjp is the project file) INSTALLATION --------------------------- NOTE: Before installing URLFetch please ensure that you have the latest Microsoft Virtual Machine installed on your server. This can be obtained from http://www.microsoft.com/java/. To install URLFetch follow these steps: 1. Download the urlfetch.zip file. 2. Unzip the file. 3. Optionally move the files urlfetch.dll and urlfetch.class to a different directory (often it's helpful to put them in the directory where most of the other DLLs on your system are contained, such as \winnt\system32 on WindowsNT or \windows\system on Windows95/98). 4. Open a DOS prompt. 5. Navigate to the directory where the files urlfetch.dll and urlfetch.class are located. 6. Type the following: Regsvr32 URLFetch.dll NOTE: --------------------------- 1. You must install the SDKJava kit first then copy the modules URLFetch.dll and URLFetch. class to C:\WINNT\SYSTEM32\ then run REGSVR32 URLFetch.dll. 2. If you use the method URLObj.SetAuthorization then, if the destination directory is accessed via IIS it must have "Basic Authentication" enabled. LICENSE --------------------------- URLFetch (An ASP COM object written in Java that allows for the retrieval of files via HTTP) Copyright (C) 2002 ekiwi, LLC This program is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. The GNU General Public License may be found at the following URL: http://www.gnu.org/copyleft/lgpl.html DISCLAIMER --------------------------- URLFetch is a free component. We don't currently offer any formal support or a warranty for the component. Many people have tested URLFetch on different platforms and configurations, but it may have bugs in it that we haven't encountered. As such, we will not be held responsible for any problems URLFetch may cause with your software. We're using the Library General Public License in the hope that people will be able to enhance it to suit their needs. Basically this means that you're free to modify URLFetch as you see fit (we've given you the source code), but if you distribute it you need to package it with the source code so that others may do the same. Use it and be happy! VERSION HISTORY --------------------------- 1.0.1: Bug fix. A carriage return and line feed weren't being inserted after each line read. 1.0.2: Proxy support added by Dave Walsh (paige386@yahoo.com). 1.0.3: Enhanced proxy server authentication by Graeme Bullimore (graeme.bullimore@btinternet.com). 1.0.4: Added support for SSL. Removed public URL variable. Added SetURL method. 1.1: Added support for binary files, which meant creating the SetIsBinary and GetBinary methods. Added the SaveAsFile method. 1.1.1: Fixed a minor bug related to content being aggregated with multiple requests. 1.2: Changed the license for URLFetch from the GPL to the LGPL. 1.2.5: Added SetConnectionTimeout and SetContentReceivedTimeout methods. CONTRIBUTORS --------------------------- Todd Wilson (todd@screen-scraper.com). Original developer. Real Gagnon (http://www.tactika.com/realhome/realhome.html). Added base64 encoding algorithm. Dave Walsh (paige386@yahoo.com). Added proxy support. Graeme Bullimore (graeme.bullimore@btinternet.com). Enhanced proxy server authentication.