Acesso web via recursos - Revision history

Myonlake at 21:49, 21 February 2021

2021-02-21T21:49:29Z

← Older revision		Revision as of 21:49, 21 February 2021
Line 161:		Line 161:
	[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.		[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.
	[[Category:Conceitos_de_Scripting]]		[[Category:Conceitos_de_Scripting]]

	[[en:Resource Web Access]]		[[en:Resource Web Access]]
			[[fr:Ressource Acces Internet]]
			[[hu:Resource Web Access]]
			[[pt-br:Acesso_web_via_recursos]]
	[[ru:Resource Web Access]]		[[ru:Resource Web Access]]

	[[Category:Tutorials]]		[[Category:Tutorials]]

Talidan at 20:49, 23 September 2016

2016-09-23T20:49:43Z

← Older revision		Revision as of 20:49, 23 September 2016
Line 7:		Line 7:
	===Especificando componentes no arquivo meta===		===Especificando componentes no arquivo meta===
	É possível definir certos arquivos acessíveis via servidor web em seu recurso. Para fazer isso é só adicionar:		É possível definir certos arquivos acessíveis via servidor web em seu recurso. Para fazer isso é só adicionar:
	<syntaxhighlight ~~lang="lua"~~ lang="xml">		<syntaxhighlight lang="xml">
	<html src="nome-do-arquivo.ext" />		<html src="nome-do-arquivo.ext" />
	</syntaxhighlight>		</syntaxhighlight>
Line 17:		Line 17:

	Um exemplo:		Um exemplo:
	<syntaxhighlight ~~lang="lua"~~ lang="xml">		<syntaxhighlight lang="xml">
	<html src="image.gif" raw="true" />		<html src="image.gif" raw="true" />
	</syntaxhighlight>		</syntaxhighlight>
Line 25:		Line 25:

	Por exemplo:		Por exemplo:
	<syntaxhighlight ~~lang="lua"~~ lang="html4strict">		<syntaxhighlight lang="html4strict">
	<html>		<html>
	<body>		<body>
Line 35:		Line 35:
	Há também uma maneira mais simples (muito utilizada no PHP e ASP) de se escrever o código acima:		Há também uma maneira mais simples (muito utilizada no PHP e ASP) de se escrever o código acima:

	<syntaxhighlight ~~lang="lua"~~ lang="html4strict">		<syntaxhighlight lang="html4strict">
	<html>		<html>
	<body>		<body>
Line 57:		Line 57:

	Para fazer isto, é só adicionar a linha abaixo em seu meta.xml:		Para fazer isto, é só adicionar a linha abaixo em seu meta.xml:
	<syntaxhighlight ~~lang="lua"~~ lang="xml">		<syntaxhighlight lang="xml">
	<export function='functionName' http='true' />		<export function='functionName' http='true' />
	</syntaxhighlight>		</syntaxhighlight>
Line 76:		Line 76:

	Primeiro, adicione esta linha no meta:		Primeiro, adicione esta linha no meta:
	<syntaxhighlight ~~lang="lua"~~ lang="xml">		<syntaxhighlight lang="xml">
	<include resource="ajax" />		<include resource="ajax" />
	</syntaxhighlight>		</syntaxhighlight>

	Segundo, adicione o código a seguir dentro de <head> na página da qual deseja chamar a função:		Segundo, adicione o código a seguir dentro de <head> na página da qual deseja chamar a função:
	<syntaxhighlight ~~lang="lua"~~ lang="lua">		<syntaxhighlight lang="lua">
	<* = exports.ajax:start(getResourceName(getThisResource())) *>		<* = exports.ajax:start(getResourceName(getThisResource())) *>
	</syntaxhighlight>		</syntaxhighlight>
Line 90:		Line 90:

	'''meta.xml'''		'''meta.xml'''
	<syntaxhighlight ~~lang="lua"~~ lang="xml">		<syntaxhighlight lang="xml">
	<meta>		<meta>
	<include resource="ajax" />		<include resource="ajax" />
Line 100:		Line 100:

	'''code.lua'''		'''code.lua'''
	<syntaxhighlight ~~lang="lua"~~ lang="lua">		<syntaxhighlight lang="lua">
	function showChatMessage ( message )		function showChatMessage ( message )
	outputChatBox ( message )		outputChatBox ( message )
Line 108:		Line 108:

	'''page.htm'''		'''page.htm'''
	<syntaxhighlight ~~lang="lua"~~ lang="html4strict">		<syntaxhighlight lang="html4strict">
	<html>		<html>
	<head>		<head>

Cristiano Cardoso at 22:04, 8 February 2015

2015-02-08T22:04:01Z

← Older revision		Revision as of 22:04, 8 February 2015
Line 160:		Line 160:
	==Veja mais==		==Veja mais==
	[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.		[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.
	[[Category:~~Translated/Scripting Concepts~~]]		[[Category:Conceitos_de_Scripting]]
	[[en:Resource Web Access]]		[[en:Resource Web Access]]
	[[ru:Resource Web Access]]		[[ru:Resource Web Access]]
	[[Category:Tutorials]]		[[Category:Tutorials]]

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Acesso web via recursos to Acesso web via recursos

2015-02-08T22:02:58Z

Cristiano Cardoso moved page PT-BR/Acesso web via recursos to Acesso web via recursos

← Older revision

Revision as of 22:02, 8 February 2015

Fabervox at 12:13, 29 September 2014

2014-09-29T12:13:00Z

← Older revision		Revision as of 12:13, 29 September 2014
Line 160:		Line 160:
	==Veja mais==		==Veja mais==
	[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.		[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.
	[[Category:Scripting Concepts]]		[[Category:Translated/Scripting Concepts]]
	[[en:Resource Web Access]]		[[en:Resource Web Access]]
	[[ru:Resource Web Access]]		[[ru:Resource Web Access]]
	[[Category:Tutorials]]		[[Category:Tutorials]]

Cristiano Cardoso: Translated!

2014-07-06T23:57:48Z

Translated!

New page

O Multi Theft Auto disponibiliza uma interface web a ser usada pelos recursos de diferentes formas. A proposta deste artigo é descrever-las e explicar sua utilização.

==Introdução==
Há dois componentes chaves desse ecossistema. O primeiro é um servidor web comum, o qual permite os navegadores demandarem páginas e arquivos presentes no recurso. O segundo é um componente que gerencia chamadas realizadas pelos navegadores à funções exportadas de seu recurso.

==Páginas==
===Especificando componentes no arquivo meta===
É possível definir certos arquivos acessíveis via servidor web em seu recurso. Para fazer isso é só adicionar:
<syntaxhighlight lang="lua" lang="xml">
<html src="nome-do-arquivo.ext" />
</syntaxhighlight>
Você pode acessar esse arquivo ao digitar o link: <nowiki>http://host:port/nome-do-recurso/nome-do-arquivo.ext</nowiki><br/>
Um exemplo seria um servidor local usando a porta http padrão e com o ''webmap'' iniciado: http://127.0.0.1:22005/webmap/map.htm

===Arquivos binários===
Tirando a possibilidade de você errar o nome, os arquivos usando a ''tag'' html podem ser de qualquer tipo. Se eles forem binários (como imagens, .zip), será necessário especificar isso na ''tag'' usando ''raw=true''. Isso significa que ele não será pre-processado antes de serem enviado ao servidor web.

Um exemplo:
<syntaxhighlight lang="lua" lang="xml">
<html src="image.gif" raw="true" />
</syntaxhighlight>

===Arquivos Processados===
Se um arquivo não for binário, então terá de ser pré-processado antes de ser retornado ao cliente. Esse processamento funciona de um jeito muito parecido com PHP ou ASP, mas usa o método do LUA. Você pode inserir scripts do MTA em uma página HTML, controlando sua saída. Quase todas as funções funcionam, incluindo determinadas [[Template:HTTP functions|Funções HTTP]], como [[httpWrite]]; o qual escreve um texto no buffer.

Por exemplo:
<syntaxhighlight lang="lua" lang="html4strict">
<html>
<body>
Esse recurso é chamado de <* httpWrite( getResourceName(getThisResource()) ) *>
</body>
<html>
</syntaxhighlight>

Há também uma maneira mais simples (muito utilizada no PHP e ASP) de se escrever o código acima:

<syntaxhighlight lang="lua" lang="html4strict">
<html>
<body>
Esse recurso é chamado de <* = getResourceName(getThisResource()) *>
</body>
<html>
</syntaxhighlight>

Junto com as funções HTTP, o Lua trabalha com variáveis específicas que contém informações sobre a página demandada:
* table '''requestHeaders''': É uma tabela contendo todas as ''headers'' requisitadas junto com a página. Você pode definir quais serão retornadas com [[httpSetResponseHeader]].
* table '''form''': Essa tabela abriga todos os dados enviados à página usando ''HTTP POST'' seguidos de quaisquer variáveis enviadas à ''querystring'' usando HTTP GET.
* table '''cookies''': Essa contém todos os cookies. É possível altera-los usando [[httpSetResponseCookie]].
* string '''hostname''': É uma ''string'' contendo o endereço de IP ou o nome do host da página requisitada.
* string '''url''': É a URL da página.
* account '''user''': Retorna a conta do usuário atual.

É importante lembrar que os arquivos estão em uma máquina virtual separada do resto do seu recurso. Como também, se desejar chamar alguma função presente no script dele, ela terá de ser exportada, e mais tarde, usando-a chamando o [[call]] na página criada.

==Calls==
É possível definir certas funções a serem chamadas via HTTP. Todos os SDKs (listados abaixo) lhe permitem fazer isso remotamente.

Para fazer isto, é só adicionar a linha abaixo em seu meta.xml:
<syntaxhighlight lang="lua" lang="xml">
<export function='functionName' http='true' />
</syntaxhighlight>

A sua função pode ser escrita normalmente e retornar quantas variáveis for preciso; incluindo tabelas, recursos, e o mais importante: elementos. Em contrapartida, ''não'' é possível retornar qualquer variável do tipo ''userdata'', como ''[[xmlnode|xmlnodes]]'' ou funções.

==Protocolos==
{{Dica|Não é preciso aprender isso, a não ser que você esteja escrevendo seu próprio código de ''HTTP request''. Se desejar, use uma das [[#SDK|SDKs listadas abaixo]].}}

Chamadas são feitas ao se utilizar ''<nowiki>http://<IP>:<porta>/<recurso>/call/<função-exportada></nowiki>' usando ''HTTP POST''. O corpo do comando pode ser uma ''array'' JSON contendo argumentos a serem enviados à função.

A resposta HTTP também será uma ''array'' JSON contendo valor(es) retornados pela função.

O servidor suporta autenticação HTTP básica e você poderá configurar-la via ACL e pelo sistema padrão de contas.

===Chamadas via interface web HTTP===
Chamadas são praticamente a coisa mais fácil a ser feita pela interface web.

Primeiro, adicione esta linha no meta:
<syntaxhighlight lang="lua" lang="xml">
<include resource="ajax" />
</syntaxhighlight>

Segundo, adicione o código a seguir dentro de <head> na página da qual deseja chamar a função:
<syntaxhighlight lang="lua" lang="lua">
<* = exports.ajax:start(getResourceName(getThisResource())) *>
</syntaxhighlight>

E a partir de agora, é só digitar um bloco em javascript e chamar as funções quase como se fossem locais. A única diferença é que as chamadas são assíncronas. Não se esqueça de especificar uma função a qual receberá o retorno HTTP no último argumento.

Aí vai um exemplo:

'''meta.xml'''
<syntaxhighlight lang="lua" lang="xml">
<meta>
<include resource="ajax" />
<script src='code.lua' />
<html src='page.htm' default='true' />
<export function='showChatMessage' http='true' />
</meta>
</syntaxhighlight>

'''code.lua'''
<syntaxhighlight lang="lua" lang="lua">
function showChatMessage ( message )
outputChatBox ( message )
return 5;
end
</syntaxhighlight>

'''page.htm'''
<syntaxhighlight lang="lua" lang="html4strict">
<html>
<head>
<* = exports.ajax:start(getResourceName(getThisResource())) *>
<script type='text/javascript'>
function say() {
var message = document.getElementById('message')
showChatMessage ( message.value,
function ( number ) {
// the function has been called and returned something
message.value = "The function returned " + number;
}
);
}
</script>
</head>
<body>
<input type='text' id='message' /><input type='button' value='say' onclick='say();' />
</body>
</html>
</syntaxhighlight>

É possível ver alguns exemplos um pouco complexos de como se utiliza esse método nos recursos''resourcebrowser'', ''resourcemanager'' e ''webadmin''.

==Garantindo segurança na interface web==
O [[PT-BR/ACL|ACL]] contém um certo número de permissões que podem afetar a maneira como os arquivos são acessados.
{{Componente_ultrapassado|3.0139|1.3.1|
* general.http: Se for desativada, nenhum dos arquivos http poderão ser acessados (excluindo os do cliente)
** '''É importante lembrar''': ''Se essa for ativada, todos os recursos (definidos nesse ACL) ganharão acesso automaticamente. Para desabilitar isso em recursos com funções exportadas, é preciso explicitar o bloqueio.''
** '''É importante lembrar''': ''Se for ativada em um ACL contendo um usuário sem senha (ex: user.*, user.guest ou user.http_guest), é recomendado bloquear o acesso à recursos que contém funções exportadas ao HTTP.''
* resource.'''Nome-do-recurso''': Se for desabilitada, nenhum dos arquivos do recurso poderão ser acessados
* resource.'''Nome-do-recurso'''.file.'''Nome-do-arquivo''': Se for desabilitada, este não poderá ser acessado
* resource.'''Nome-do-recurso'''.function.'''Nome-da-função''': Se for desabilitada, a função não poderá ser chamada

Todos esses acima funciona com outras permissões do ACL; ou seja, é possível desabilita-los para usuários comuns ou só permitir acesso aos administradores. Ou até mesmo a outro grupo de usuários credenciados.
}}
{{Novo_componente|3.0139|1.3.1|
* '''resource.Nome-do-recurso.http''': Se for habilitada, o recurso será acessível a partir do endereço: http://ip_do_servidor:22005/Nome_do_recurso/
Isso funciona para outras permissões do ACL também, ou seja, é possível habilitar-la só a administradores ou um grupo específico.
}}

==SDK==
Há alguns dos tão conhecidos SDKs disponíveis para interagir com o servidor a partir de outras linguagens de programação. Com isso, é possível (em teoria) escrever gamemodes completos. Na prática, é uma má ideia, porém útil para estatísticas e administração. O SDK de PHP é o mais desenvolvido. Sinta-se a vontade de modificar ou criar seu próprio SDK - não se esqueça de nos mandar uma cópia, por favor!

* [[JavaSDK|Java SDK]]
* [[Javascript SDK]]
* [[Perl SDK]]
* [[PHP SDK]]
* [[CSharp SDK|C# SDK]]

==Veja mais==
[[callRemote]] - Permite a chamada de funções em páginas PHP (com o SDK próprio) e incluise em outros servidores.
[[Category:Scripting Concepts]]
[[en:Resource Web Access]]
[[ru:Resource Web Access]]
[[Category:Tutorials]]