Internet InetGet InetGet ( "URL" [,"nazwa pliku" [, opcje [, w_tle]]] ) Funkcja pobiera plik z internetu za pomocą protokołów HTTP, HTTPS lub FTP i zapisuje go na dysku. Wartość zwracana zależy od parametru w_tle.
"URL" - URL pliku do pobrania. Format np.: "http://www.somesite.com/path/file.html". Aby użyć nazwy użytkownika i hasła podczas łączenia należy poprzedzić nimi wprowadzany URL, np.: "http://moj_login:[email protected]".
Pozostałe parametry opcjonalne:
"nazwa_pliku" - nazwa pod którą będzie zapisany pobrany plik.
opcje - opcje:
0 - (domyślnie) jeżeli to możliwe, plik pobierany jest z lokalnego cache.
1 - wymuszenie pobrania z internetu (nawet gdy plik jest dostępny w lokalnym cache).
2 - ignorowanie wszystkich błędów SSL w czasie łączenia z HTTPS.
4 - przy pobieraniu z FTP dane traktowane jako ASCII.
8 - przy pobieraniu z FTP dane traktowane jako binarne (jest to tryb domyślny transferu).
Można sumować opcje (z wyjątkiem 4 i 8, które wzajemnie się wykluczają).
w_tle - parametr określający czy funkcja ma wstrzymać wykonanie skryptu do czasu zakończenia pobierania:
0 - (domyślnie) funkcja czeka na zakończenie pobierania (funkcja zwraca ilość pobranych bajtów)
1 - pobieranie w tle. Funkcja zwraca uchwyt, który może być wykorzystany w InetGetInfo() aby sprawdzić stan pobierania. Uchwyt musi być zwolniony przez InetClose(). W tym trybie możliwe jest pobieranie jednocześnie kilku plików. Aby przerwać pobieranie należy użyć InetClose().
Jeżeli wystąpił błąd to dla w_tle=0, funkcja zwróci 0, a makro @error przyjmie wartość różną od zera. Dla w_tle=1 funkcja zwróci uchwyt, i żeby stwierdzić że wystąpił błąd pobierania należy użyć InetGetInfo().
Przykład: $n=InetGet("http://www.autoitscript.com/autoit3/files/graphics/autoit_10_wall_1920x1200.jpg", _ "d:/autoit_10_wall_1920x1200.jpg") SplashImageOn("Wczytano: " & $n & " bajtów.", "d:/autoit_10_wall_1920x1200.jpg") Sleep(3000)
InetRead InetRead ( "URL" [, opcje] ) Funkcja zwraca plik pobrany z internetu za pomocą protokołów HTTP, HTTPS lub FTP, w makrze @extended zwracana jest ilość wczytanych bajtów.
Jeżeli wystąpił błąd funkcja zwróci 0, a makro @error przyjmie wartość różną od zera.
Parametry "URL" i opcje - jak dla InetGet().
Przykład: $download = InetRead("http://www.autoitscript.com") MsgBox(0, "Wczytano: " & @extended & " bajtów.", BinaryToString($download)) Sleep(3000)
InetGetInfo InetGetInfo ( [uchwyt [, indeks]] ) Zwraca szczegółowe dane dla uchwytu zwróconego przez InetGet(), lub pusty string ("") jeżeli wystąpił błąd (makro @error<>0).
Parametry (oba opcjonalne):
uchwyt - uchwyt zwrócony przez InetGet().
indeks - określa rodzaj zwracanej informacji:
-1 - zwracana jest tablica zawierająca w kolejnych komórkach wszystkie poniższe informacji
0 - ilość dotychczas wczytanych bajtów, jest aktualizowane w miarę postępu wczytywania
1 - rozmiar pliku do pobrania (nie zawsze jest dostępny)
2 - TRUE jeżeli pobieranie zakończone, FALSE jeżeli trwa
3 - TRUE jeżeli pobieranie zakończone sukcesem, FALSE jeżeli wystąpił błąd
4 - @error, jeżeli różny od zera to wystąpił błąd pobierania
5 - @extended, w zasadzie tylko dla developerów AutoIt'a
Jeśli funkcja będzie wywołana bez argumentów wtedy zwrócona będzie całkowita liczba aktywnych pobrań.
Funkcja może być wywoływana w pętli do kontroli postępów wczytywania, lub po zakończeniu wczytywania.
Przykład: $h=InetGet("http://www.autoitscript.com/autoit3/files/graphics/autoit_10_wall_1920x1200.jpg", _ @TempDir & "\update.dat", 1, 1) Do Sleep(250) Until InetGetInfo($h, 2) ;czekanie na zakończenie wczytywania $a = InetGetInfo($h) ;pobranie wszystkich informacji InetClose($h) ;zwolnienie uchwytu MsgBox(0, "", "Bajtów wczytanych: " & $a & @CRLF & _ "Bajtów do pobrania: " & $a & @CRLF & _ "Kompletność: " & $a & @CRLF & _ "Sukces: " & $a & @CRLF & _ "@error = " & $a & @CRLF & _ "@extended = " & $a & @CRLF)
InetGetSize InetGetSize ( "URL" [, opcje] ) Funkcja zwraca wielkość w bajtach pliku w internecie, lub 0 gdy wystąpił błąd (makro @error<>0).
Parametry "URL" i opcje - jak dla InetGet().
UWAGA: Nie wszystkie serwery będą poprawnie podać rozmiar pliku, zwłaszcza gdy korzystamy z serwera proxy.
Przykład: $Size = InetGetSize("http://www.autoitscript.com/autoit3/files/graphics/autoit_10_wall_1920x1200.jpg") MsgBox(0, "InetGetSize:", "Wielkość pliku: " & $Size & " bajtów")
InetClose InetClose ( uchwyt ) Funkcja zwalnia uchwyt pobrany przez InetGet(). Zwraca TRUE, jeśli uchwyt został znaleziony i zwolniony, FALSE jeśli nie.
uchwyt - uchwyt zwrócony przez InetGet().
UWAGA:
Po zakończeniu pobierania uchwyt musi być zwolniony, inaczej mogą wystąpić błędy.
Wywołanie InetClose() przed zakończeniem pobierania spowoduje jego anulowanie.
FtpSetProxy FtpSetProxy ( mod [, "proxy:port" [, "użytkownik" [, "hasło"]]] ) Ustawienie serwera proxy dla protokółu FTP. Funkcja nie zwraca żadnej wartości.
Wszystkie parametry i uwagi jak dla HttpSetProxy.
Przykład: FtpSetProxy(2, "www-cache.myisp.net:8080")
HttpSetProxy HttpSetProxy ( mod [, "proxy:port" [, "użytkownik" [, "hasło"]]] ) Ustawienie serwera proxy dla protokółu HTTP. Funkcja nie zwraca żadnej wartości.
mod - sposób użycia serwera proxy:
0 - (domyślnie) użycie bieżących ustawień Internet Explorer'a dla proxy
1 - nie używanie serwera proxy (bezpośredni dostęp)
2 - użycie określonego serwera proxy
Pozostałe opcjonalnie:
"proxy:port" - adres i port serwera proxy.
"użytkownik" - nazwa użytkownika na serwerze proxy.
"hasło" - hasło użytkownika na serwerze proxy.
UWAGA:
1. Obsługiwane są tylko serwery proxy zgodne ze standardem CERN.
2. Serwery proxy zazwyczaj składa się z adresu i numeru portu. Większość usługodawców internetowych używa numeru portu 8080, np. dla serwera proxy www.proxy.com, parametr proxy:port będzie miał postać: "www.proxy.com:8080".
Przykład: HttpSetProxy(2, "www-cache.myisp.net:8080")
HttpSetUserAgent HttpSetUserAgent ( "nagłówek" ) Funkcja ustawia nagłówek wysyłany podczas komunikacji z serwerem WWW (przez funkcje, InetGet(), InetGetSize() i InetRead). Zwraca poprzedni nagłówek.
"nagłówek" - string nowego nagłówka (ang. User agent)
HttpSetUserAgent("MyUserAgent")
Ping Ping ( "addres" [, czas] ) Funkcja zwraca tzw. ping, czyli czas (w ms) oczekiwania na odpowiedź internetowego hosta, lub 0 gdy wystąpił błąd.
Jeżeli wystąpił błąd makro @error przyjmuje jedną z następujących wartości: 1 = host nie jest zalogowany 2 = host jest nieosiągalny 3 = złe miejsce 4 = inne błędy (np. zły adres)
"adres" - nazwa lub adres hosta (np.: "www.autoitscript.com" lub "87.106.244.38").
czas - max. czas oczekiwania na odpowiedź hosta (wartość domyślna 4000).
Przykład: $ping = Ping("pl.wikibooks.org", 250) If $ping Then MsgBox(0, "Ping:", "Odpowiedź hosta po: " & $ping & " ms") Else MsgBox(0, "Ping:", "Wystąpił błąd nr: " & @error) EndIf
TCP Co to jest TCP? TCP (ang. Transmission Control Protocol) – połączeniowy, niezawodny, strumieniowy protokół komunikacyjny wykorzystywany do przesyłania danych pomiędzy procesami uruchomionymi na różnych komputerach. W przeciwieństwie do UDP, TCP gwarantuje dostarczenie wszystkich pakietów w całości, z zachowaniem kolejności i bez duplikatów, jednak kosztem zwiększonej ilości przesyłanych danych.
TCP jest protokołem działającym w trybie klient-serwer. Serwer oczekuje na nawiązanie połączenia na określonym porcie. Klient inicjuje połączenie do serwera. Połączenie jest realizowane przez tzw. gniazda czyli dwukierunkowe punkty końcowe połączenia. Dwukierunkowość oznacza możliwość wysyłania i przyjmowania danych.
Gniazdo ma następujące cechy:
1. Typ gniazda identyfikujący protokół wymiany danych, TCP lub UDP.
2. Lokalny adres IP.
3. Numer portu identyfikujący proces, który wymienia dane przez gniazdo.
Aby nawiązać połączenie protokółem TPC należy uruchomić skrypty na dwóch komputerach, z których jeden będzie serwerem, a drugi klientem. Skrypt serwera musi być uruchomiony jako pierwszy.
Tworzenie serwera TCP 1. Uruchomienie usługi TCP (TCPStartup).
2. Utworzenie głównego gniazda nasłuchu połączeń przychodzących (TCPListen).
3. Tworzenie pętli nasłuchu:
- zezwolenie na próby połączenia przychodzącego na gnieździe (TCPAccept)
- odebranie danych z podłączonego gniazda (TCPRecv)
- zamknięcie otwartych połączeń (TCPCloseSocket)
Przykładowy skrypt serwera (adres IP należy dostosować do własnych realiów): ;TCP serwer TCPStartup() ;start usługi TCP $mainsocket = TCPListen("127.0.0.1", 65432) ;utworzenie głównego gniazda nasłuchu While 1 ;pętla nasłuchiwania $acceptedSocket = TCPAccept($mainsocket) ;możliwe połączenie do zaakceptowania If $acceptedSocket <> -1 Then ;jeśli $acceptedSocket jest różne od -1, ... $receivedData = TCPRecv($acceptedSocket, 1024) ;jeśli gniazdo jest połączone odbieramy pakiet od klienta MsgBox(64, "Wiadomość otrzymana!", "Otrzymałem wiadomość: " & $receivedData) TCPCloseSocket($acceptedSocket) ;zamknięcie otwartych połączeń EndIf WEnd
Tworzenie klienta TCP 1. Uruchomienie usługi TCP (TCPStartup).
2. Łączenie z serwerem (TCPConnect).
3. Przesłanie pakietu danych do serwera (TCPSend).
4. Zamknięcie otwartego połączenia (TCPCloseSocket).
5. Zamknięcie usługi TCP (TCPShutdown).
Przykładowy skrypt klienta (adres IP należy dostosować do własnych realiów): ;TCP klient TCPStartup() ;start usługi TCP $socket = TCPConnect("127.0.0.1", 65432) ;próbuje połączyć się z serwerem i zapisuje nr gniazda w $socked If $socket = -1 Then ;jeśli $socket = -1, komunikat o błędach MsgBox(16, "Błąd:", "Połączenie z serwerem nie można ustalić!") EndIf $sendedBytes = TCPSend($socket, "Pozdrowienia z komputera klienta :)") ;wysyła wiadomość do połączonego gniazda If $sendedBytes = 0 Then ;jeśli wartość zwracana TCPSend(...) = 0 to wystąpił błąd MsgBox(16, "Error", "Pakiet nie może być wysłany.") ;komunikat błędu EndIf TCPCloseSocket($socket) ;zamknięcie otwartego połączenia TCPShutdown() ;koniec usługi TCP
Szczegółowy opis funkcji TCP TCPStartup TCPStartup ( ) Funkcja wywołuje usługę TCP. Zwraca 1 gdy sukces, lub 0 gdy wystąpił błąd (makro @error zawiera kod błędu API).
Funkcja jest używana po stronie serwera i klienta.
TCPAccept TCPAccept ( gniazdo_główne ) Funkcja zezwala na przychodzące połączenia na gnieździe serwera. Zwraca identyfikator gniazda klienta, które wykonuje połączenie, lub -1 gdy wystąpił błąd (makro @error zawiera kod błędu API).
gniazdo_główne - identyfikator gniazda serwera, zwracany przez funkcję TCPListen.
Funkcja jest używana po stronie serwera.
TCPConnect TCPConnect ( IP, port ) Funkcja tworzy gniazdo podłączone do istniejącego serwera. Zwraca identyfikator gniazda, lub -1 gdy wystąpił błąd. Makro @error przyjmuje wartość:
1 - zły adres IP
2 - zły nr portu
IP - adres IP serwera.
port - numer portu na którym będzie realizowane połączenie.
Funkcja jest używana po stronie klienta.
TCPListen TCPListen ( IP, port [, max] ) Funkcja tworzy gniazdo nasłuch na połączenia przychodzące. Zwraca identyfikator gniazda, lub -1 gdy wystąpił błąd. Makro @error przyjmuje wartość:
1 - zły adres IP
2 - zły nr portu
IP - adres IP serwera.
port - numer portu na którym będzie realizowane połączenie.
max - (opcjonalnie) maksymalna długość kolejki oczekujących połączeń.
Funkcja jest używana po stronie serwera.
TCPRecv TCPRecv ( gniazdo_główne, max_długość [, flaga] ) Funkcja odbiera dane z podłączonego gniazda. Zwraca dane w postaci stringu lub łańcucha binarnego. Jeżeli wystąpi błąd zwracany jest pusty string, a makro @error przyjmuje wartość -1.
gniazdo_główne - identyfikator gniazda serwera, zwracany przez funkcję TCPListen.
max_długość - maksymalna długość odbieranych danych (znaków lub bajtów).
flaga - (opcjonalnie) sposób traktowania odebranych danych:
0 - dane traktowane jako string (wartość domyślna)
1 - dane traktowane jako łańcuch binarny
Funkcja jest używana po stronie serwera.
TCPSend TCPSend ( gniazdo_główne, dane )