Difference between revisions of "UrlLoader.new"

From GiderosMobile
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
<languages />
+
'''Available since:''' Gideros 2012.2.2<br/>
'''<translate>Available since</translate>:''' Gideros 2012.2.2<br/>
+
'''Class:''' [[UrlLoader]]<br/>
'''<translate>Class</translate>:''' [[Special:MyLanguage/UrlLoader|UrlLoader]]<br/>
+
 
=== <translate>Description</translate> ===
+
=== Description ===
<translate><br />
+
Creates a new '''UrlLoader''' object.
Creates a new [[Special:MyLanguage/UrlLoader|UrlLoader]] object.<br />
 
<br />
 
''url'' parameter specifies the URL to download. This parameter is optional and if specified loading starts immediately.<br />
 
<br />
 
''method'' parameter specifies the HTTP request method. It can be one of the values of [[Special:MyLanguage/UrlLoader.GET|UrlLoader.GET]], [[Special:MyLanguage/UrlLoader.POST|UrlLoader.POST]], [[Special:MyLanguage/UrlLoader.PUT|UrlLoader.PUT]] or [[Special:MyLanguage/UrlLoader.DELETE|UrlLoader.DELETE]].<br />
 
The default HTTP method is [[Special:MyLanguage/UrlLoader.GET|UrlLoader.GET]].<br />
 
<br />
 
''body'' parameter specifies the HTTP body data. This parameter is used only when the HTTP method is [[Special:MyLanguage/UrlLoader.POST|UrlLoader.POST]] or or [[Special:MyLanguage/UrlLoader.PUT|UrlLoader.PUT]].<br />
 
<br />
 
After loading is finished, loaded data is stored at ''event.data'' field of [[Special:MyLanguage/Event.COMPLETE|Event.COMPLETE]] event as string.<br />
 
<br /></translate>
 
 
<source lang="lua">
 
<source lang="lua">
UrlLoader.new(url,method,headers,body)
+
UrlLoader.new(url,method,headers,body)
 
</source>
 
</source>
=== <translate>Parameters</translate> ===
+
 
'''url''': (string, optional) <translate>URL to download. This parameter is optional and if specified loading starts immediately.</translate> <br/>
+
 
'''method''': (string, default = "get") <translate>HTTP request method.</translate> <br/>
+
''method'' parameter specifies the HTTP request method. It can be one of the values of '''[[UrlLoader.GET]]''', '''[[UrlLoader.POST]]''', '''[[UrlLoader.PUT]]''' or '''[[UrlLoader.DELETE]]'''. The default HTTP method is '''UrlLoader.GET'''
'''headers''': (table, optional) <translate>HTTP headers.</translate> <br/>
+
 
'''body''': (string, optional) <translate>HTTP body data. This data is sent as the message body of a request.</translate> <br/>
+
''body'' parameter specifies the HTTP body data. This parameter is used only when the HTTP method is '''UrlLoader.POST''' or '''UrlLoader.PUT'''
=== <translate>Examples</translate> ===
+
 
'''Example'''<br/>
+
 
<source lang="lua">local url = "http://www.[yourDomain].com/application.php?userid=gideros&login=guest"
+
After loading is finished, loaded data is stored as a string in the ''event.data'' field of [[Event.COMPLETE]] event.
 +
 
 +
=== Parameters ===
 +
'''url''': (string, optional) URL to download. This parameter is optional and if specified loading starts immediately<br/>
 +
'''method''': (string, default = "get") HTTP request method<br/>
 +
'''headers''': (table, optional) HTTP headers<br/>
 +
'''body''': (string, optional) HTTP body data. This data is sent as the message body of a request<br/>
 +
 
 +
=== Examples ===
 +
<source lang="lua">
 +
local url = "http://www.[yourDomain].com/application.php?userid=gideros&login=guest"
  
 
local loader1 = UrlLoader.new(url)
 
local loader1 = UrlLoader.new(url)
Line 38: Line 37:
 
["User-Agent"] = "Gideros Browser",
 
["User-Agent"] = "Gideros Browser",
 
}
 
}
local loader6 = UrlLoader.new(url, UrlLoader.PUT, headers, "key=value")</source>
+
local loader6 = UrlLoader.new(url, UrlLoader.PUT, headers, "key=value")
 +
</source>
  
 
{{UrlLoader}}
 
{{UrlLoader}}

Revision as of 12:18, 12 March 2023

Available since: Gideros 2012.2.2
Class: UrlLoader

Description

Creates a new UrlLoader object.

UrlLoader.new(url,method,headers,body)


method parameter specifies the HTTP request method. It can be one of the values of UrlLoader.GET, UrlLoader.POST, UrlLoader.PUT or UrlLoader.DELETE. The default HTTP method is UrlLoader.GET
body parameter specifies the HTTP body data. This parameter is used only when the HTTP method is UrlLoader.POST or UrlLoader.PUT


After loading is finished, loaded data is stored as a string in the event.data field of Event.COMPLETE event.

Parameters

url: (string, optional) URL to download. This parameter is optional and if specified loading starts immediately
method: (string, default = "get") HTTP request method
headers: (table, optional) HTTP headers
body: (string, optional) HTTP body data. This data is sent as the message body of a request

Examples

local url = "http://www.[yourDomain].com/application.php?userid=gideros&login=guest"

local loader1 = UrlLoader.new(url)
local loader2 = UrlLoader.new(url, UrlLoader.GET) -- same as the previous line
local loader3 = UrlLoader.new(url, UrlLoader.POST, "my post data")
local loader4 = UrlLoader.new(url, UrlLoader.PUT, "my put data")
local loader5 = UrlLoader.new(url, UrlLoader.DELETE)

local headers = {
	["Content-Type"] = "application/x-www-form-urlencoded",
	["User-Agent"] = "Gideros Browser",
}
local loader6 = UrlLoader.new(url, UrlLoader.PUT, headers, "key=value")