...
Services Disponibilizados pela Arquitetura
| Informações |
|---|
Nesta seção, ao mencionar services estamos nos referindo a factories, services e providers, ou seja, toda e qualquer implementação destes componentes. Isto ocorre pois service é um nome genérico que pode ser utilizado para documentação, porém o AngularJS utiliza deste nome para componentes também. |
Services são objetos compostos primariamente por funções, passíveis de injeção de dependências e não possuem estadoinicializados . Um serviço no framework AngularJS é tratado como um singleton e pode ser injetado através de seu nome, bastando declara-lo como parametro em seus componentes (no caso, um controller, por exemplo). Para maiores informações acesse a documentação oficial sobre services.
...
| Nome | Descrição | Utilização |
|---|---|---|
properties | A partir do nome de objeto, busca todas as propriedades deste objeto no back-end. |  |
range | A partir de um objeto e um atributo, busca a série se existente no arquivo de internacionalização. |
|
Submit Service
É um serviço declarado através do framework AngularJS que expõe funções públicas para trabalhar com propriedades, encapsulando a complexidade de realizar requisições HTTP para o desenvolvedor. Para maiores informações, leia a documentação de resources.Que expõe funções que mapeiam os métodos genéricos CRUD da arquitetura back-end. Internamente as requisições HTTP são tratadas e processadas, tornando-se transparente para o desenvolvedor.
As funções disponíveis publicamente são:
| Nome | Descrição | Utilização | ||
|---|---|---|---|---|
| properties | A partir do nome de objeto, busca todas as propriedades deste objeto no back-end. |  | ||
| range | A partir de um objeto e um atributo, busca a série se existente no arquivo de internacionalização. |  create | Realiza uma chamada HTTP POST para a URL configurada no Após sua execução, este método delega ao back-end a responsabilidade de inserção e recebe como resposta, no caso de sucesso, um objeto contendo o id do objeto gerado pelo back-end ou, caso de falha, os erros gerados pelo back-end na inserção. |  |
update | Realiza uma chamada HTTP PUT para a URL configurada no Após sua execução, este método delega ao back-end a responsabilidade de atualização de um objeto já persistido. Se a operação ocorrer com sucesso e houver um callback registrado, este é executado e não recebe nenhum parametro . Em caso de falha, se houver callback de falha registrado, é executado e recebe os erros gerados pelo back-end. |
| ||
delete | Realiza uma chamada HTTP DELETE para a URL configurada no MessageProvider durante a inicialização da aplicação. Esta configuração mapeia a URL base dos endpoints RESTful genéricos que implementam as operações CRUD. O objeto enviado como primeiro argumento deve conter o atributo object com valor do tipo String, contendo o nome da entidade que será excluida e um atributo id com o identificador unico da entidade já persistida no banco de dados. O segundo é terceiro parametro são callbacks opcionais, de sucesso e falha. |  | ||
retrieve | Realiza uma chamada HTTP GET para a URL configurada no MessageProvider durante a inicialização da aplicação. Esta configuração mapeia a URL base dos endpoints RESTful genéricos que implementam as operações CRUD. O objeto enviado como primeiro argumento deve conter o atributo object com valor do tipo String, contendo o nome da entidade que será persistida. O segundo parâmetro é o objeto JSON com os dados a serem persistidos. O terceiro é quarto parametro são callbacks opcionais, de sucesso e falha. |  | ||
find | Realiza uma chamada HTTP GET para a URL configurada no MessageProvider durante a inicialização da aplicação. Esta configuração mapeia a URL base dos endpoints RESTful genéricos que implementam as operações CRUD. O objeto enviado como primeiro argumento deve conter o atributo object com valor do tipo String, contendo o nome da entidade que será persistida. O segundo parâmetro é o objeto JSON com os dados a serem persistidos. O terceiro é quarto parametro são callbacks opcionais, de sucesso e falha. |  |
| Informações | ||
|---|---|---|
| ||
Estas funções não realizam nenhuma lógica adicional, apenas encapsulam as operações HTTP para a chamada de endpoints RESTful genéricos. Assim, é de responsabilidade da camada de serviços a implementação destas operações e a garantia de sua exeução. |
Directives Disponibilizadas pela Arquitetura
Nesta seção abordaremos como cada directive disponível na arquitetura funciona internamente.
...