Configurando Um Servidor xData
Índice
Criação do Banco
Este artigo abordará como criar e configurar um servidor XData que usa o mapeamento gerado pelo Aurelius como base.
Criação e configuração dos Componentes
Forma Manual de Criação
Crie um formulário Windows Vcl Aplication e adicione os seguintes componentes:
- XDataServer
- SparkleHttpSysDispatcher
- XDataConnectionPool
- AureliusConnection
- Algum conector de banco (Ex: TFdConnection)
Opcional: Criar os componentes usando o Wizard
É possível acelerar o processo de criação dos componentes usando um dos Wizard do Xdata, localizado em File->New->Other->TMS XData ->TMS XData Web Application.
Além de automaticamente adicionar todo os componentes necessários (exceto o conector de banco, que deve ser adicionado manualmente), o XData Web Application também cria uma tela usada para iniciar, parar e reiniciar o servidor sem ter que fechar a aplicação.
Configurações:XDataServer
- BaseUrl: Selecione uma url base registrada para ser usado pelo sevidor.
NOTA: Verifique se a url foi devidamente registrada antes de ser usada.O registro de url é explicado nesta página
- DefaultEntitySetPermissions: Adicionar todas as permissões (List, Get, Insert, Modify e Delete)
- Dispatcher: Adicione o componente SparkleHttpSysDispatcher usado no projeto
- Pool: Adicionar o XDataConnectionPool usado no projeto
Configurações:SparkleHttpSysDispatcher
- Active: Ativar essa opção
Configurações: AureliusConnection
- AdapterName: Nome do conector de banco utilizado
- AdaptedConnection: nome do tipo de adapatador usado (FireDac, etc)
NOTA: Estas configurações podem também ser feitas no Aurelius Connection Editor, acessado com dois cliques no AureliusConnection, ou clicando no botão direito e em Connection Settings.
Configurações: XDataConnectionPool
- Connection: Colocar o componente AureliusConnection usado no projeto
- Size: Define o número máximo de conexões (ou seja, usuários) permitidos para o servidor
Criando O Mapeamento Do Banco
Para criar o mapeamento do banco, clique com o botão direito no AureliusConnection e vá em Generate entities from the database. Vai ser então aberto uma nova tela, com três abas: Mapping, Advanced Settings e Preview.
- Na aba de Mapping, selecione quais tabelas serão mapeadas.
- Na aba de Advanced Settings selecione a opção "Check for Missing Sequences", e mude para Never.
- Na aba de Preview, verifique se ocorre alguma mensagem de erro quando a aba é acessada. Caso não ocorra, a prévia do código do mapeamento aparecerá na tela.
AVISO: Usando esse meio, todas as tabelas serão mapeadas para um único arquivo. Caso queira criar múltiplos arquivos de mapeamento, acesse a página de configuração do DataModeler.
Após todas as configurações, clique no botão "Ok" para que o arquivo seja gerado.
Configurações Adicionais do Banco
Após a configuração dos componentes e o mapeamento das classes, também é necessário fazer a configuração do código do servidor xdata.
Adicione as variáveis Connection, Server Container e Manager.
700px
Além disso, adcione o código abaixo no evento "onCreate" do DataModule:
