📄 jvurlgrabbers.pas
字号:
{-----------------------------------------------------------------------------
The contents of this file are subject to the Mozilla Public License
Version 1.1 (the "License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.mozilla.org/MPL/MPL-1.1.html
Software distributed under the License is distributed on an "AS IS" basis,
WITHOUT WARRANTY OF ANY KIND, either expressed or implied. See the License for
the specific language governing rights and limitations under the License.
The Original Code is: JvUrlGrabbers.Pas, released on 2003-08-04.
The Initial Developer of the Original Code is Olivier Sannier [obones att altern dott org]
Portions created by Olivier Sannier are Copyright (C) 2003 Olivier Sannier.
All Rights Reserved.
Contributor(s): -
You may retrieve the latest version of this file at the Project JEDI's JVCL home page,
located at http://jvcl.sourceforge.net
Known Issues:
-----------------------------------------------------------------------------}
// $Id: JvUrlGrabbers.pas,v 1.43 2005/03/09 14:57:32 marquardt Exp $
unit JvUrlGrabbers;
{$I jvcl.inc}
{$I windowsonly.inc}
{$HPPEMIT '#pragma link "wininet.lib"'}
interface
uses
{$IFDEF UNITVERSIONING}
JclUnitVersioning,
{$ENDIF UNITVERSIONING}
Windows, Contnrs, Classes, SysUtils,
JvUrlListGrabber, JvTypes;
type
// A grabber for FTP URLs
TJvFtpDownloadMode = (hmBinary, hmAscii);
TJvFtpUrlGrabberDefaultProperties = class(TJvCustomUrlGrabberDefaultProperties)
protected
FPassive: Boolean;
FMode: TJvFtpDownloadMode;
function GetSupportedURLName: string; override;
public
procedure Assign(Source: TPersistent); override;
constructor Create(AOwner: TJvUrlGrabberDefaultPropertiesList); override;
published
property Agent;
property UserName;
property Password;
property Port default 21;
property Passive: Boolean read FPassive write FPassive default True;
property Mode: TJvFtpDownloadMode read FMode write FMode default hmBinary;
end;
TJvFtpUrlGrabber = class(TJvCustomUrlGrabber)
protected
FPassive: Boolean;
FMode: TJvFtpDownloadMode;
function GetGrabberThreadClass: TJvCustomUrlGrabberThreadClass; override;
procedure DoStatus; override;
public
constructor Create(AOwner: TComponent); overload; override;
constructor Create(AOwner: TComponent; AUrl: string; DefaultProperties: TJvCustomUrlGrabberDefaultProperties); overload;
class function CanGrab(const Url: string): Boolean; override;
class function GetDefaultPropertiesClass: TJvCustomUrlGrabberDefaultPropertiesClass; override;
class function GetSupportedProtocolMarker: string; override;
class function GetSupportedURLName: string; override;
published
property Passive: Boolean read FPassive write FPassive default True;
property Mode: TJvFtpDownloadMode read FMode write FMode default hmBinary;
property UserName;
property Password;
property FileName;
property OutputMode;
property Agent;
property Url;
property Port default 21;
property OnDoneFile;
property OnDoneStream;
property OnError;
property OnProgress;
property OnResolvingName;
property OnNameResolved;
property OnConnectingToServer;
property OnConnectedToServer;
property OnSendingRequest;
property OnRequestSent;
property OnRequestComplete;
property OnReceivingResponse;
property OnResponseReceived;
property OnClosingConnection;
property OnConnectionClosed;
property OnRedirect;
property OnStatusChange;
end;
TJvFtpUrlGrabberThread = class(TJvCustomUrlGrabberThread)
protected
function GetGrabber: TJvFtpUrlGrabber;
procedure Closed;
procedure Execute; override;
public
property Grabber: TJvFtpUrlGrabber read GetGrabber;
end;
// A grabber for HTTP URLs
TJvHttpUrlGrabber = class(TJvCustomUrlGrabber)
private
FReferer: string;
protected
function GetGrabberThreadClass: TJvCustomUrlGrabberThreadClass; override;
procedure DoStatus; override;
public
constructor Create(AOwner: TComponent; AUrl: string; DefaultProperties: TJvCustomUrlGrabberDefaultProperties);
class function CanGrab(const Url: string): Boolean; override;
class function GetDefaultPropertiesClass: TJvCustomUrlGrabberDefaultPropertiesClass; override;
class function GetSupportedProtocolMarker: string; override;
class function GetSupportedURLName: string; override;
published
property Referer: string read FReferer write FReferer;
property UserName;
property Password;
property FileName;
property OutputMode;
property Agent;
property Url;
property Port default 80;
property OnDoneFile;
property OnDoneStream;
property OnError;
property OnProgress;
property OnResolvingName;
property OnNameResolved;
property OnConnectingToServer;
property OnConnectedToServer;
property OnSendingRequest;
property OnRequestSent;
property OnRequestComplete;
property OnReceivingResponse;
property OnResponseReceived;
property OnClosingConnection;
property OnConnectionClosed;
property OnRedirect;
property OnStatusChange;
end;
TJvHttpUrlGrabberDefaultProperties = class(TJvCustomUrlGrabberDefaultProperties)
private
FReferer: string;
protected
function GetSupportedURLName: string; override;
public
constructor Create(AOwner: TJvUrlGrabberDefaultPropertiesList); override;
published
property Referer: string read FReferer write FReferer;
property Agent;
property UserName;
property Password;
property Port default 80;
end;
TJvHttpUrlGrabberThread = class(TJvCustomUrlGrabberThread)
protected
FContinue: Boolean;
function GetGrabber: TJvHttpUrlGrabber;
procedure Execute; override;
procedure Closed;
public
constructor Create(Grabber: TJvCustomUrlGrabber); override;
property Grabber: TJvHttpUrlGrabber read GetGrabber;
end;
// A grabber for local and UNC files
TJvLocalFileUrlGrabber = class(TJvCustomUrlGrabber)
private
FPreserveAttributes: Boolean;
protected
function GetGrabberThreadClass: TJvCustomUrlGrabberThreadClass; override;
public
constructor Create(AOwner: TComponent); overload; override;
constructor Create(AOwner: TComponent; AUrl: string; DefaultProperties: TJvCustomUrlGrabberDefaultProperties); overload;
class function CanGrab(const Url: string): Boolean; override;
class function GetDefaultPropertiesClass: TJvCustomUrlGrabberDefaultPropertiesClass; override;
class function GetSupportedProtocolMarker: string; override;
class function GetSupportedURLName: string; override;
procedure ParseUrl(Url: string; Protocol: string; var Host: string; var FileName: string;
var UserName: string; var Password: string; var Port: Cardinal); overload; override;
procedure ParseUrl(const Url: string; var FileName: string); reintroduce; overload;
published
property PreserveAttributes: Boolean read FPreserveAttributes write FPreserveAttributes default True;
property UserName;
property Password;
property FileName;
property OutputMode;
property Agent;
property Url;
property OnDoneFile;
property OnDoneStream;
property OnError;
property OnProgress;
property OnResolvingName;
property OnNameResolved;
property OnConnectingToServer;
property OnConnectedToServer;
property OnSendingRequest;
property OnRequestSent;
property OnRequestComplete;
property OnReceivingResponse;
property OnResponseReceived;
property OnClosingConnection;
property OnConnectionClosed;
property OnRedirect;
property OnStatusChange;
end;
TJvLocalFileUrlGrabberThread = class(TJvCustomUrlGrabberThread)
protected
function GetGrabber: TJvLocalFileUrlGrabber;
procedure Execute; override;
public
property Grabber: TJvLocalFileUrlGrabber read GetGrabber;
end;
TJvLocalFileUrlGrabberProperties = class(TJvCustomUrlGrabberDefaultProperties)
private
FPreserveAttributes: Boolean;
protected
function GetSupportedURLName: string; override;
public
constructor Create(AOwner: TJvUrlGrabberDefaultPropertiesList); override;
procedure Assign(Source: TPersistent); override;
published
property PreserveAttributes: Boolean read FPreserveAttributes write FPreserveAttributes default True;
end;
{$IFDEF UNITVERSIONING}
const
UnitVersioning: TUnitVersionInfo = (
RCSfile: '$RCSfile: JvUrlGrabbers.pas,v $';
Revision: '$Revision: 1.43 $';
Date: '$Date: 2005/03/09 14:57:32 $';
LogPath: 'JVCL\run'
);
{$ENDIF UNITVERSIONING}
implementation
uses
WinInet,
JvResources;
const
cFilePrefix = 'file://';
cHTTPPrefix = 'http://';
cFTPPrefix = 'ftp://';
{$IFDEF COMPILER5}
function FtpGetFileSize(hFile: HINTERNET; lpdwFileSizeHigh: LPDWORD): DWORD; stdcall;
external 'wininet.dll' name 'FtpGetFileSize';
{$ENDIF COMPILER5}
// global download callback
procedure RegisterUrlGrabberClasses;
begin
// register the classes
JvUrlGrabberClassList.Add(TJvFtpUrlGrabber);
JvUrlGrabberClassList.Add(TJvHttpUrlGrabber);
JvUrlGrabberClassList.Add(TJvLocalFileUrlGrabber);
end;
procedure DownloadCallBack(Handle: HINTERNET; Context: DWORD;
AStatus: DWORD; Info: Pointer; StatLen: DWORD); stdcall;
begin
with TJvCustomUrlGrabberThread(Context) do
begin
Status := AStatus;
DoProgress;
DoStatus;
end;
end;
// helper function to get the last error message from the internet functions
function GetLastInternetError: string;
var
dwIndex: DWORD;
dwBufLen: DWORD;
Buffer: PChar;
begin
dwIndex := 0;
dwBufLen := 1024;
GetMem(Buffer, dwBufLen);
InternetGetLastResponseInfo(dwIndex, Buffer, dwBufLen);
Result := StrPas(Buffer);
FreeMem(Buffer);
end;
// helper procedure to trigger various events depending on the
// value of the given status.
procedure TriggerEventsFromStatus(Grabber: TJvCustomUrlGrabber; InternetStatusValue: DWORD);
begin
with Grabber do
case InternetStatusValue of
INTERNET_STATUS_RESOLVING_NAME:
if Assigned(OnResolvingName) then
OnResolvingName(Grabber);
INTERNET_STATUS_NAME_RESOLVED:
if Assigned(OnNameResolved) then
OnNameResolved(Grabber);
INTERNET_STATUS_CONNECTING_TO_SERVER:
if Assigned(OnConnectingToServer) then
OnConnectingToServer(Grabber);
INTERNET_STATUS_CONNECTED_TO_SERVER:
if Assigned(OnConnectedToServer) then
OnConnectedToServer(Grabber);
INTERNET_STATUS_SENDING_REQUEST:
if Assigned(OnSendingRequest) then
OnSendingRequest(Grabber);
INTERNET_STATUS_REQUEST_SENT:
if Assigned(OnRequestSent) then
OnRequestSent(Grabber);
INTERNET_STATUS_RECEIVING_RESPONSE:
if Assigned(OnReceivingResponse) then
OnReceivingResponse(Grabber);
INTERNET_STATUS_RESPONSE_RECEIVED:
if Assigned(OnResponseReceived) then
OnResponseReceived(Grabber);
INTERNET_STATUS_CLOSING_CONNECTION:
if Assigned(OnClosingConnection) then
OnClosingConnection(Grabber);
INTERNET_STATUS_CONNECTION_CLOSED:
if Assigned(OnConnectionClosed) then
OnConnectionClosed(Grabber);
INTERNET_STATUS_REQUEST_COMPLETE:
if Assigned(OnRequestComplete) then
OnRequestComplete(Grabber);
INTERNET_STATUS_REDIRECT:
if Assigned(OnRedirect) then
OnRedirect(Grabber);
INTERNET_STATUS_STATE_CHANGE:
if Assigned(OnStatusChange) then
OnStatusChange(Grabber);
end;
end;
//=== { TJvHttpUrlGrabber } ==================================================
constructor TJvHttpUrlGrabber.Create(AOwner: TComponent; AUrl: string;
DefaultProperties: TJvCustomUrlGrabberDefaultProperties);
begin
inherited Create(AOwner, AUrl, DefaultProperties);
Port := 80;
end;
class function TJvHttpUrlGrabber.CanGrab(const Url: string): Boolean;
begin
Result := LowerCase(Copy(Url, 1, 7)) = cHTTPPrefix;
end;
class function TJvHttpUrlGrabber.GetDefaultPropertiesClass: TJvCustomUrlGrabberDefaultPropertiesClass;
begin
Result := TJvHttpUrlGrabberDefaultProperties;
end;
function TJvHttpUrlGrabber.GetGrabberThreadClass: TJvCustomUrlGrabberThreadClass;
begin
Result := TJvHttpUrlGrabberThread;
end;
class function TJvHttpUrlGrabber.GetSupportedProtocolMarker: string;
begin
Result := cHTTPPrefix;
end;
class function TJvHttpUrlGrabber.GetSupportedURLName: string;
begin
Result := 'HTTP';
end;
procedure TJvHttpUrlGrabber.DoStatus;
begin
inherited DoStatus;
TriggerEventsFromStatus(Self, UrlGrabberThread.Status);
end;
//=== { TJvFtpUrlGrabber } ===================================================
constructor TJvFtpUrlGrabber.Create(AOwner: TComponent);
begin
inherited Create(AOwner);
Port := 21;
Passive := True;
Mode := hmBinary;
end;
constructor TJvFtpUrlGrabber.Create(AOwner: TComponent; AUrl: string;
DefaultProperties: TJvCustomUrlGrabberDefaultProperties);
begin
inherited Create(AOwner, AUrl, DefaultProperties);
// (rom) added check. TODO add else (probably exception).
if DefaultProperties is TJvFtpUrlGrabberDefaultProperties then
begin
Passive := TJvFtpUrlGrabberDefaultProperties(DefaultProperties).Passive;
Mode := TJvFtpUrlGrabberDefaultProperties(DefaultProperties).Mode;
end;
end;
class function TJvFtpUrlGrabber.CanGrab(const Url: string): Boolean;
begin
Result := LowerCase(Copy(Url, 1, 6)) = cFTPPrefix;
end;
class function TJvFtpUrlGrabber.GetDefaultPropertiesClass: TJvCustomUrlGrabberDefaultPropertiesClass;
begin
Result := TJvFtpUrlGrabberDefaultProperties;
end;
function TJvFtpUrlGrabber.GetGrabberThreadClass: TJvCustomUrlGrabberThreadClass;
begin
Result := TJvFtpUrlGrabberThread;
end;
class function TJvFtpUrlGrabber.GetSupportedProtocolMarker: string;
begin
Result := cFTPPrefix;
end;
class function TJvFtpUrlGrabber.GetSupportedURLName: string;
begin
Result := 'FTP';
end;
procedure TJvFtpUrlGrabber.DoStatus;
begin
inherited DoStatus;
TriggerEventsFromStatus(Self, UrlGrabberThread.Status);
end;
//=== { TJvFtpUrlGrabberDefaultProperties } ==================================
constructor TJvFtpUrlGrabberDefaultProperties.Create(AOwner: TJvUrlGrabberDefaultPropertiesList);
begin
inherited Create(AOwner);
FPassive := True;
FMode := hmBinary;
Port := 21;
end;
procedure TJvFtpUrlGrabberDefaultProperties.Assign(Source: TPersistent);
begin
inherited Assign(Source);
if Source is TJvFtpUrlGrabberDefaultProperties then
with Source as TJvFtpUrlGrabberDefaultProperties do
begin
Self.Mode := Mode;
Self.Passive := Passive;
end;
end;
function TJvFtpUrlGrabberDefaultProperties.GetSupportedURLName: string;
begin
Result := TJvFtpUrlGrabber.GetSupportedURLName;
end;
//=== { TJvFtpUrlGrabberThread } =============================================
procedure TJvFtpUrlGrabberThread.Closed;
begin
Grabber.DoClosed;
end;
procedure TJvFtpUrlGrabberThread.Execute;
const
cPassive: array [Boolean] of DWORD = (0, INTERNET_FLAG_PASSIVE);
var
hSession, hHostConnection, hDownload: HINTERNET;
HostName, FileName, strUserName, strPassword: string;
UserName, Password: PChar;
Port: Cardinal;
LocalBytesRead, TotalBytes: DWORD;
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -