O sdk integra a linguagem de programação com o barramento e permite que os serviços possam ser implementados em qualquer linguagem.
Atualmente o SDK está implementado somente na linguagem Java.
###Exemplo de Web Service em ErlangMS
A classe Java a seguir, implementa um Web Service na plataforma ErlangMS. Qualquer classe Java que herde da classe base EmsServiceFacade é um Web Service. Essas classes são vistas pelo barramento como agentes.
@Singleton
@Startup
public class ValorAlimentacaoService extends EmsServiceFacade {
@EJB
private ValorAlimentacaoNegocio negocio;
public ValorAlimentacao findById(IEmsRequest request){
Integer id = request.getParamAsInt("id");
return negocio.findById(id);
}
public List<ValorAlimentacao> find(IEmsRequest request){
String filtro = request.getQuery("filtro");
String fields = request.getQuery("fields");
int limit_ini = request.getQueryAsInt("limit_ini");
int limit_fim = request.getQueryAsInt("limit_fim");
String sort = request.getQuery("sort");
return negocio.pesquisar(filtro, fields, limit_ini, limit_fim, sort);
}
public ValorAlimentacao insert(IEmsRequest request){
ValorAlimentacao obj = (ValorAlimentacao) request.getObject(ValorAlimentacao.class);
return negocio.insert(obj);
}
public ValorAlimentacao update(IEmsRequest request){
final int id = request.getParamAsInt("id");
ValorAlimentacao obj = negocio.findById(id);
request.mergeObjectFromPayload(obj);
return negocio.update(obj);
}
}===
###Registro no Catálogo de Serviço ErlangMS
É preciso fazer o registro das operações que serão expostas como serviço no catálogo de serviço do barramento ErlangMS. O catálogo de serviços está localizado na pasta priv/conf/catalogo e segue um layout JSON.
O exemplo a seguir, demonstra o contrato dos serviços para a classe java ValorAlimentacaoService.
Lembre-se, a classe Web Service precisa implementar o contrato de serviço. As regras de negócio da parte negocial é tipicamente implementada na camada de negócio e o Web Service em si, é uma fachada.
{
"name": "/sae/valoralimentacao",
"comment": "Pesquisar valor alimentação",
"owner": "sae",
"version": "1",
"service" : "br.unb.service.sae.ValorAlimentacaoService:find",
"url": "/sae/valoralimentacao",
"host": "negocio1",
"type": "GET",
"APIkey":"true",
"querystring": [
{
"name": "filtro",
"type": "string",
"default" : "",
"comment": "Filtro principal da pesquisa"
},
{
"name": "fields",
"type": "string",
"default" : "",
"comment": "Campos que devem ser retornados na pesquisa"
},
{
"name": "limit_ini",
"type": "int",
"default" : "0",
"comment": "Limite inicial do paginador"
},
{
"name": "limit_fim",
"type": "int",
"default" : "100",
"comment": "Limite final do paginador"
},
{
"name": "sort",
"type": "string",
"default" : "",
"comment": "Campos que devem ser ordenados"
},
],
},
{
"name": "/sae/valoralimentacao/:id",
"comment": "Retorna valor alimentação específico",
"owner": "sae",
"version": "1",
"service" : "br.unb.service.sae.ValorAlimentacaoService:findById",
"url": "/sae/valoralimentacao/:id",
"host": "negocio1",
"type": "GET"
},
{
"name": "/sae/valoralimentacao/:id",
"comment": "Modifica valor alimentação",
"owner": "sae",
"version": "1",
"service" : "br.unb.service.sae.ValorAlimentacaoService:update",
"url": "/sae/valoralimentacao/:id",
"host": "negocio1",
"type": "PUT"
},
{
"name": "/sae/valoralimentacao",
"comment": "Cadastrar valor alimentação",
"owner": "sae",
"version": "1",
"service" : "br.unb.service.sae.ValorAlimentacaoService:insert",
"url": "/sae/valoralimentacao",
"host": "negocio1",
"type": "POST"
},
{
"name": "/sae/valoralimentacao/:id",
"comment": "Excluir valor alimentação",
"owner": "sae",
"version": "1",
"service" : "br.unb.service.sae.ValorAlimentacaoService:delete",
"url": "/sae/valoralimentacao",
"host": "negocio1",
"type": "DELETE"
}
===
###Invocando os Serviços no Barramento ErlangMS
Os exemplos a seguir, demonstram como consumir os serviços registrados no catálogo de serviços do barramento ErlangMS.
Em REST, os serviços normalmente são chamados de recursos e são invocados por meio dos verbos HTTP a seguir:
GET -> para listar os recursos
POST -> para criar um recurso
PUT -> para modificar um recurso
DELETE -> para excluir um recurso
Foi utilizado o utilitário de linha de comando curl para fazer as requisições HTTP/REST.
####a) Cadastrar um novo recurso valoralimentacao por meio de uma requisição POST
Comando curl da requisição:
curl -X POST localhost:2301/sae/valoralimentacao -d"{\"campus\":1,\"pagaBeneficio\":\"true\",\"valorBeneficio\":\"500\",\"inicioVigencia\":\"30/12/2015\"}"
{"id":5,"campus":1,"inicioVigencia":"30/12/2015","pagaBeneficio":true,"valorBeneficio":"500.00"}
Log do barramento ErlangMS:
POST /sae/valoralimentacao HTTP/1.1 {
RID: 1445814176848195406
Accept: */*:
User-Agent: curl/7.38.0
Content-Type: application/x-www-form-urlencoded
Payload: {"campus":1,"pagaBeneficio":"true","valorBeneficio":"500","inicioVigencia":"30/12/2015"}
Service: br.unb.service.sae.ValorAlimentacaoService:insert em ValorAlimentacaoService@puebla
Query: []
Status: 200 <<ok>> (4ms)
Send: ok
}
CAST br.unb.service.sae.ValorAlimentacaoService:insert em ValorAlimentacaoService@puebla {RID: 1445814344754159263, URI: /sae/valoralimentacao}.
####b) Listar todos os registros do recurso valoralimentacao por meio de uma requisição GET
Comando curl da requisição:
curl -X GET localhost:2301/sae/valoralimentacao
[{"id":1,"campus":1,"inicioVigencia":"10/12/2015","pagaBeneficio":true,"valorBeneficio":"120.00"},
{"id":2,"campus":2,"inicioVigencia":"30/12/2015","pagaBeneficio":true,"valorBeneficio":"500.00"},
{"id":3,"campus":3,"inicioVigencia":"13/11/2016","pagaBeneficio":false,"valorBeneficio":"250.00"},
{"id":4,"campus":4,"inicioVigencia":"01/01/2018","pagaBeneficio":true,"valorBeneficio":"800.00"},
{"id":5,"campus":5,"inicioVigencia":"10/05/2015","pagaBeneficio":false,"valorBeneficio":"600.00"}
]
Log do barramento ErlangMS:
GET /sae/valoralimentacao HTTP/1.1 {
RID: 1445815782848467549
Accept: */*:
User-Agent: curl/7.38.0
Service: br.unb.service.sae.ValorAlimentacaoService:find em ValorAlimentacaoService@puebla
Query: []
Status: 200 <<ok>> (3ms)
Send: ok
}
CAST br.unb.service.sae.ValorAlimentacaoService:find em ValorAlimentacaoService@puebla {RID: 1445815782848467549, URI: /sae/valoralimentacao}.
####c) Modifica um recurso valoralimentacao por meio de uma requisição PUT
Comando curl da requisição:
curl -X PUT localhost:2301/sae/valoralimentacao/1 -d"{\"campus\":4}"
{"id":1,"campus":4,"inicioVigencia":"10/12/2015","pagaBeneficio":true,"valorBeneficio":"120.00"}Log do barramento ErlangMS
PUT /sae/valoralimentacao/1 HTTP/1.1 {
RID: 1445815941960292134
Accept: */*:
User-Agent: curl/7.38.0
Content-Type: application/x-www-form-urlencoded
Payload: {"campus":4}
Service: br.unb.service.sae.ValorAlimentacaoService:update em ValorAlimentacaoService@puebla
Query: []
Status: 200 <<ok>> (5ms)
Send: ok
}
CAST br.unb.service.sae.ValorAlimentacaoService:update em ValorAlimentacaoService@puebla {RID: 1445815941960292134, URI: /sae/valoralimentacao/1}.