28-08-2016, Saat: 11:30
(Son Düzenleme: 07-12-2020, Saat: 16:31, Düzenleyen: mrmarman.
Sebep: Proje linki güncellendi. (GoogleDrive)
)
Herkese merhaba.
WSDL web service olayına aşina olmak isteyip de ürken arkadaşlar için basit bir yaklaşım tasarladım.
Web Service konusu bilindiği üzere, bilgisayarınızı bir WEB sunucusu haline getiren, üçüncü parti herhangi bir yazılım/donanım altyapısı ihtiyacı olmayan oldukça faydalı bir yapıdır.
Mevcut projenizde de dahil edilmesi basittir. Hali hazırdaki VCL Form Application durumunda herhangi bir modifikasyona ihtiyaç duyulmaz. Sadece UNIT eklenir ve Web Servis / Server anında hazır.
Kullanım alanı oldukça geniştir. Kullanım alanı örnekleri derken
Ana projemizde değerli vaktimizi akıllı bir sistem kurmaya ayırmış oluyoruz. WEB üzerinden gelen çağrı / veri vs. ne olursa ana projemize alarak aynı anda değerlendirdiğimiz sonucu yine sorgulayan WEB istemcisine response (cevap) olarak yollayabilirsiniz.
GET veya POST ile verilerinizi yollayabilirsiniz. Projeniz kabul edecek be içeriği bir REQUEST.Content ile size sunacaktır.
Sizin yapacağınız bu içeriği PARSE ederek size gereken kaynak veriyi elde etmek ve sonucu aldığınızı veya varsa cevabınızı RESPONSE.Content olarak atamak. Bu arada hangi IP/HOST/ WebBrowser/Referer vs. WEB üzerine olabilecek tüm veri yine sizin önünüze akacaktır.
Size bir de bonus olarak Image stream edebilmeyi dahil ettim. Yani bir resmi WEB çağrısına nasıl eklediğimizi de proje kaynak kodlarıyla irdeleyebilirsiniz.
Local Ağ'da herhangi bir sorun olmayacaktır. Ancak !!!
WEB üzerinden gelen çağrıları kabul için modem / ağ PORT yönlendirme bilgisi olmayanlar :
- Lütfen öncelikle WEB üzerinden belirlediğiniz PORT numarasından gelen çağrıları, dahili ağınızdaki projenizin olduğu bilgisayara yönlendirme nasıl yapılır ( ROUTING ) üzerine makalelere yeniden bir göz atınız. Bunun önemle altını çiziyorum. Keza bu ve benzeri sistemlerin çalışması, gelen çağrıların size ulaşmasıyla orantılıdır.
Bu Unit ve örnek projeyi bu linkten indirebilirsiniz.
Örnek Proje Unit İçerik
WSDL web service olayına aşina olmak isteyip de ürken arkadaşlar için basit bir yaklaşım tasarladım.
Web Service konusu bilindiği üzere, bilgisayarınızı bir WEB sunucusu haline getiren, üçüncü parti herhangi bir yazılım/donanım altyapısı ihtiyacı olmayan oldukça faydalı bir yapıdır.
Mevcut projenizde de dahil edilmesi basittir. Hali hazırdaki VCL Form Application durumunda herhangi bir modifikasyona ihtiyaç duyulmaz. Sadece UNIT eklenir ve Web Servis / Server anında hazır.Kullanım alanı oldukça geniştir. Kullanım alanı örnekleri derken
- Mobil Cihazınızdan Desktop Win32 uygulamanıza anlık GPS bilgisi gönderir alır mesela lojistik veya öğrenci servisi takibi yapabilir,
- Stok kontrol işlemlerinizde basit bir WiFi ağı ile ürün sorgulayabilir cevabını online ana veritabanından alabilir,
- Mesajlaşma (Chat) kanalı kurar server destekli basit bir mesajlaşma ara birimi oluşturabilir,
- Projelerinizi WEB üzerinden birbiri ile konuşturarak uzak şehirler arasında hızlı veritabanı / bilgi paylaşımı yapabilir,
- Projelerinizin hali hazırda WEB ile olan irtibatını daha da zenginleştirebilirsiniz.
Ana projemizde değerli vaktimizi akıllı bir sistem kurmaya ayırmış oluyoruz. WEB üzerinden gelen çağrı / veri vs. ne olursa ana projemize alarak aynı anda değerlendirdiğimiz sonucu yine sorgulayan WEB istemcisine response (cevap) olarak yollayabilirsiniz.
GET veya POST ile verilerinizi yollayabilirsiniz. Projeniz kabul edecek be içeriği bir REQUEST.Content ile size sunacaktır.Sizin yapacağınız bu içeriği PARSE ederek size gereken kaynak veriyi elde etmek ve sonucu aldığınızı veya varsa cevabınızı RESPONSE.Content olarak atamak. Bu arada hangi IP/HOST/ WebBrowser/Referer vs. WEB üzerine olabilecek tüm veri yine sizin önünüze akacaktır.
Size bir de bonus olarak Image stream edebilmeyi dahil ettim. Yani bir resmi WEB çağrısına nasıl eklediğimizi de proje kaynak kodlarıyla irdeleyebilirsiniz.
Local Ağ'da herhangi bir sorun olmayacaktır. Ancak !!!
WEB üzerinden gelen çağrıları kabul için modem / ağ PORT yönlendirme bilgisi olmayanlar : - Lütfen öncelikle WEB üzerinden belirlediğiniz PORT numarasından gelen çağrıları, dahili ağınızdaki projenizin olduğu bilgisayara yönlendirme nasıl yapılır ( ROUTING ) üzerine makalelere yeniden bir göz atınız. Bunun önemle altını çiziyorum. Keza bu ve benzeri sistemlerin çalışması, gelen çağrıların size ulaşmasıyla orantılıdır.
{***************************************************************************}
{ }
{ WSDL Helper Class }
{ }
{ Copyright © 2016 Muharrem ARMAN }
{ muharrem.arman@trt.net.tr }
{ }
{***************************************************************************}
{ }
{ Suya SOAP'a Dokunmadan [ : ) ] Web Service Altyapısını tek bir }
{ HelperUnit ile projenize kazandıran altyapıdır }
{ }
{ USES listesine bu UNIT'in eklenmesi yeterlidir. }
{ Ekstra bir tanımlamaya gerek yoktur. }
{ Gerekli WebService sınıfı kendiliğinden create edilecek, OnWebCagriGeldi }
{ eventi atanmışsa çağrı projeniz tarafından dikkate alınacaktır. }
{ }
{ Kullanımı : }
{ (1) Formunuzun Private kısmına aşağıdaki tanımı ekleyiniz... }
{ }
{ procedure OnWebCagriGeldi(Sender: TObject; Request : TWebRequest; }
{ Response: TWebResponse ); }
{ }
{ (2) Formun OnCreate olayına da aşağıdaki size özel tanımları yapınız. }
{ }
{ xWSDLHelper.DefaultPort := 7000; // sizin için uygun olanı neyse }
{ xWSDLHelper.ServerActive := True; }
{ xWSDLHelper.OnWebCagriGeldi := OnWebCagriGeldi; }
{ }
{ (3) OnWebCagriGeldi olayına da aşağıdaki dilediğinizi yapınız. }
{ }
{ procedure TForm1.OnWebCagriGeldi(Sender: TObject; Request : TWebRequest; }
{ Response: TWebResponse );}
{ Var }
{ strMesaj : WideString; }
{ begin }
{ Memo1.Lines.BeginUpdate; }
{ Memo1.Lines.Add( 'RemoteIp : ' + Request.RemoteIP ); }
{ Memo1.Lines.Add( 'RemoteHost: ' + Request.RemoteHost ); }
{ Memo1.Lines.Add( 'From : ' + Request.From ); }
{ Memo1.Lines.Add( 'Host : ' + Request.Host ); }
{ Memo1.Lines.Add( 'RemoteAddr: ' + Request.RemoteAddr ); }
{ Memo1.Lines.Add( 'URL : ' + Request.URL ); }
{ Memo1.Lines.Add( 'Content : ' + Request.Content ); }
{ Memo1.Lines.EndUpdate; }
{ strMesaj := '<html>' }
{ + '<meta http-equiv=Content-Type content="text/html;' }
{ + ' charset=Windows-1254">' }
{ + '<body>' }
{ + 'Merhaba.' + '</br>' }
{ + '<font color="red">Muharrem ARMAN</font>' + '</br>' }
{ + 'Dinamik WebService TEST...' + '</br>' }
{ + '<img src="Resim_01">' + '</br>' }
{ + '<img src="Resim_01">' + '</br>' }
{ + '<img src="Resim_01">' + '</br>' }
{ + '<img src="Resim_01">' + '</br>' }
{ ; }
{ if String(Request.Host) = String(Request.RemoteAddr) }
{ then strMesaj := strMesaj + 'Beni şu IP''den çağırdınız : ' }
{ + String(Request.Host) + '</br>' }
{ else strMesaj := strMesaj + 'Beni şu DOMAIN ile çağırdınız : ' }
{ + String(Request.Host) + '</br>'; }
{ }
{ strMesaj := strMesaj + 'Sizin IP Adresiniz : ' }
{ + String(Request.RemoteAddr) + '</br>' }
{ + '</body></html>'; }
{ Response.Content := strMesaj; }
{ end; }
{ }
{***************************************************************************}
{ }
{ Üzerinde değişiklik yapmak serbesttir ancak lütfen bu etiket bloğu }
{ içine yaptığınız değişikliği ve künyenizi yazmayı ihmal etmeyiniz. }
{ }
{***************************************************************************}
{ Değişikliği Yapan, Yapılan Ekleme/Değişiklik bilgisi : }
{ }
{ }
{ }
{***************************************************************************}
Unit WSDL_HelperUnit;
interface
Uses
Windows, SysUtils, Classes,
IdHTTPWebBrokerBridge, WebReq, HTTPApp;
Type
tARMAN_WSDL = class(TWebModule)
private
procedure ARMAN_DefaultHandlerAction(Sender: TObject; Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
function ResimGonder(ResStream: TResourceStream; Response: TWebResponse): Boolean;
procedure Resim_01_Action(Sender: TObject; Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
public
constructor Create(AOwner: TComponent); override;
end;
Type
TOnWebCagriEvent = procedure(Sender: TObject; Request : TWebRequest; Response: TWebResponse ) of object;
TWSDL_Helper = Class(TObject)
private
FServer : TIdHTTPWebBrokerBridge;
FDefPort : Integer;
FOnWebCagriEvent : TOnWebCagriEvent;
Function FDefPortGet : Integer;
Procedure FDefPortSet( DefPort: Integer );
procedure FServerActivate( boolDurum: boolean = true );
function FIsServerActive: Boolean;
public
constructor Create;
destructor Destroy; Override;
property DefaultPort : Integer read FDefPortGet write FDefPortSet;
property ServerActive: boolean read FIsServerActive write FServerActivate;
property OnWebCagriGeldi: TOnWebCagriEvent read FOnWebCagriEvent write FOnWebCagriEvent;
end;
Var
WebModuleClass : TComponentClass = tARMAN_WSDL;
xWSDLHelper : TWSDL_Helper;
xTest : tARMAN_WSDL;
implementation
{$R RES\RES.RES} // basit Form Object ve Resim JPG dosyası bulunduruyor.
{ TWSDL_Helper }
constructor TWSDL_Helper.Create;
begin
inherited;
if WebRequestHandler <> nil then
WebRequestHandler.WebModuleClass := WebModuleClass;
// Create server.
FServer := TIdHTTPWebBrokerBridge.Create;
// Register web module class.
FServer.RegisterWebModuleClass( tARMAN_WSDL );
end;
destructor TWSDL_Helper.Destroy;
begin
FServer.Active := False;
FServer.Bindings.Clear;
FreeAndNil(FServer);
inherited;
end;
function TWSDL_Helper.FDefPortGet: Integer;
begin
Result := FDefPort;
end;
procedure TWSDL_Helper.FDefPortSet(DefPort: Integer);
begin
FDefPort := DefPort;
if FServer.Active
then FServer.Active := False;
FServer.Bindings.Clear;
// Set default port.
FServer.DefaultPort := FDefPort;
// Start server.
FServer.Active := True;
end;
function TWSDL_Helper.FIsServerActive: Boolean;
begin
Result := FServer.Active;
end;
procedure TWSDL_Helper.FServerActivate(boolDurum: boolean);
begin
if FServer.Active
then FServer.Active := False;
FServer.Bindings.Clear;
FServer.Active := boolDurum;
end;
{ tARMAN_WSDL }
constructor tARMAN_WSDL.Create(AOwner: TComponent);
begin
inherited;
// Varsayalın (Default) Action Ekledim.
With Actions.Add do
begin
Default := True;
Name := 'DefaultHandler';
PathInfo := '/';
OnAction := ARMAN_DefaultHandlerAction;
end;
// Yeni bir Action Ekledim. Kodla ekledim açıklayıcı olsun istedim.
With Actions.Add do
begin
Default := False;
Enabled := True;
MethodType := mtAny;
Name := 'R01_Resim';
PathInfo := 'Resim_01';
OnAction := Resim_01_Action;
end;
end;
procedure tARMAN_WSDL.ARMAN_DefaultHandlerAction(Sender: TObject;
Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
Var
strMesaj : String;
begin
// Handled := True;
if Assigned( xWSDLHelper.OnWebCagriGeldi ) then
begin
xWSDLHelper.OnWebCagriGeldi( sender, Request, Response );
end else
begin
strMesaj := '<html>'
+ '<meta http-equiv=Content-Type content="text/html; charset=Windows-1254">'
+ '<body>'
+ 'Merhaba.' + '</br>'
+ '<font color="red">Muharrem ARMAN</font>' + '</br>'
+ 'WebService TEST...' + '</br>'
+ '<img src="' + String(Request.URL) + 'Resim_01">' + '</br>'
;
if String(Request.Host) = String(Request.RemoteAddr)
then strMesaj := strMesaj + 'Beni şu IP''den çağırdınız : '+ String(Request.Host) + '</br>'
else strMesaj := strMesaj + 'Beni şu DOMAIN ile çağırdınız : '+ String(Request.Host) + '</br>';
strMesaj := strMesaj + 'Sizin IP Adresiniz : ' + String(Request.RemoteAddr) + '</br>'
+ '</body></html>';
Response.Content := strMesaj;
end;
end;
function tARMAN_WSDL.ResimGonder( ResStream:TResourceStream; Response: TWebResponse ): Boolean;
begin
try
ResStream.Position := 0;
Response.ContentStream := ResStream;
Response.ContentType := 'image/jpeg';
Response.SendResponse;
Result := True;
//Dikkat: FileStream FREE edilmeyecek çünkü yayındayız...
except
on E: Exception do begin
Response.Content := '<html><body>Bir hata ile karşılaşıldı...' +
E.ClassName + ': ' + E.Message + '</body></html>';
Result := False;
end;
end;
end;
procedure tARMAN_WSDL.Resim_01_Action(Sender: TObject; Request: TWebRequest;
Response: TWebResponse; var Handled: Boolean);
begin
Handled := True;
// Response edilirken HTML içerisinde "Resim_01" kullanılan yerlerde
// bu Action devreye girererek daha önce belirlediğimiz resmi yollar...
ResimGonder( TResourceStream.Create(HInstance, Format('img_%.2d', [1]), RT_RCDATA), Response );
end;
initialization
xWSDLHelper := TWSDL_Helper.Create;
finalization
FreeAndNil(xWSDLHelper);
end.
Bu Unit ve örnek projeyi bu linkten indirebilirsiniz. Örnek Proje Unit İçerik
unit Unit1;
interface
uses
Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Vcl.Buttons,
WSDL_HelperUnit, Web.HTTPApp, Vcl.Samples.Spin;
type
TForm1 = class(TForm)
BitBtn1: TBitBtn;
Memo1: TMemo;
SpinEdit1: TSpinEdit;
procedure BitBtn1Click(Sender: TObject);
procedure OnWebCagriGeldi(Sender: TObject; Request : TWebRequest; Response: TWebResponse );
procedure FormCreate(Sender: TObject);
private
{ Private declarations }
public
{ Public declarations }
end;
var
Form1: TForm1;
implementation
{$R *.dfm}
procedure TForm1.FormCreate(Sender: TObject);
begin
ReportMemoryLeaksOnShutdown := true;
end;
procedure TForm1.BitBtn1Click(Sender: TObject);
begin
xWSDLHelper.DefaultPort := SpinEdit1.Value;
xWSDLHelper.ServerActive := True;
xWSDLHelper.OnWebCagriGeldi := OnWebCagriGeldi;
end;
procedure TForm1.OnWebCagriGeldi(Sender: TObject; Request : TWebRequest; Response: TWebResponse );
Var
strMesaj : WideString;
begin
Memo1.Lines.BeginUpdate;
Memo1.Lines.Add( 'RemoteIp : ' + Request.RemoteIP );
Memo1.Lines.Add( 'RemoteHost: ' + Request.RemoteHost );
Memo1.Lines.Add( 'From : ' + Request.From );
Memo1.Lines.Add( 'Host : ' + Request.Host );
Memo1.Lines.Add( 'RemoteAddr: ' + Request.RemoteAddr );
Memo1.Lines.Add( 'URL : ' + Request.URL );
Memo1.Lines.Add( 'Content : ' + Request.Content );
Memo1.Lines.EndUpdate;
strMesaj := '<html>'
+ '<meta http-equiv=Content-Type content="text/html; charset=Windows-1254">'
+ '<body>'
+ 'Merhaba.' + '</br>'
+ '<font color="red">Muharrem ARMAN</font>' + '</br>'
+ 'Dinamik WebService TEST...' + '</br>'
+ '<img src="Resim_01">' + '</br>'
;
if String(Request.Host) = String(Request.RemoteAddr)
then strMesaj := strMesaj + 'Beni şu IP''den çağırdınız : '+ String(Request.Host) + '</br>'
else strMesaj := strMesaj + 'Beni şu DOMAIN ile çağırdınız : '+ String(Request.Host) + '</br>';
strMesaj := strMesaj + 'Sizin IP Adresiniz : ' + String(Request.RemoteAddr) + '</br>'
+ '</body></html>';
Response.Content := strMesaj;
end;
end.


Öyle bir class olsaydi benim gibi tembel yazilimcilarin cok isine yarardi.