You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomee.apache.org by GitBox <gi...@apache.org> on 2020/08/04 12:47:56 UTC
[GitHub] [tomee] jrxxjr opened a new pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
jrxxjr opened a new pull request #703:
URL: https://github.com/apache/tomee/pull/703
Link to Jira : https://issues.apache.org/jira/browse/TOMEE-2895
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] Daniel-Dos commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r468946959
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,398 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+#O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que utiliza a opção Concorrência Bean-Managed, bem
+como a anotação @Startup, que faz com que o bean seja instanciado pelo
+contêiner, enquanto a aplicação inicia. Beans Singleton com
+@ConcurrencyManagement(BEAN) são responsáveis por seus próprios
+thread-safety. O bean mostrado é uma simples ``registro'' de propriedade e
+provisiona um lugar onde opções podem ser definidas e recuperadas por todos os beans
+na aplicação.
Review comment:
the example does not contain annotations like @Startup, @ConcurrencyManagement(BEAN).
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] jrxxjr commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
jrxxjr commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r478791066
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
Review comment:
The change is applied.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] Daniel-Dos commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r468817715
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,398 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+#O Código
Review comment:
remover please.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] Daniel-Dos commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r468817715
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,398 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+#O Código
Review comment:
change #O Código to == O Código
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] Daniel-Dos commented on pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on pull request #703:
URL: https://github.com/apache/tomee/pull/703#issuecomment-674348642
@jrxxjr please, review .
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] jrxxjr commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
jrxxjr commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r478790975
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
Review comment:
The change is applied.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] jrxxjr commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
jrxxjr commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r478791582
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que usa as anotações @Path, @Produces e @Consumes.
+A anotação @Path identifica o modelo de caminho URI ao qual o recurso responde e é especificado no nível de classe de um recurso. O valor da anotação @Path
+é um modelo de caminho de URI parcial relativo ao URI de base do servidor no qual o recurso está implementado, a raiz de contexto do WAR e o padrão de URL
Review comment:
The change is applied.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] jrxxjr commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
jrxxjr commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r478791963
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que usa as anotações @Path, @Produces e @Consumes.
+A anotação @Path identifica o modelo de caminho URI ao qual o recurso responde e é especificado no nível de classe de um recurso. O valor da anotação @Path
+é um modelo de caminho de URI parcial relativo ao URI de base do servidor no qual o recurso está implementado, a raiz de contexto do WAR e o padrão de URL
+para o qual o servlet auxiliar Jersey responde.
+A anotação @Produces é usada para especificar os tipos de mídia MIME ou representações que um recurso pode produzir e enviar de volta ao cliente. Se @Produces
+for aplicado no nível da classe, todos os métodos em um recurso podem produzir os tipos MIME especificados por padrão. Se for aplicado no nível de método, substitui
+quaisquer anotações @Produces aplicadas no nível da classe.
+A anotação @Consumes é usada para especificar quais tipos de mídia MIME de representações um recurso pode aceitar ou consumir do cliente. Se @Consumes for
+aplicado no nível da classe, todos os métodos de resposta aceitarão os tipos MIME especificados por padrão. Se @Consumes for aplicado no nível do método, ele
+substituirá qualquer @Consumes anotações aplicadas no nível da classe.
+
+Na realidade linhas:
+
+[código,java]
+----
+@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+----
+
+são opcionais, uma vez que é a configuração padrão. E essas linhas, podem
+ser configuradas pelo método também, se você precisar para ser mais preciso.
+
+[código,java]
+----
+@Path("/greeting")
+@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+public class GreetingService {
+ @GET
+ public Response message() {
+ return new Response("Hi REST!");
+ }
+
+ @POST
+ public Response lowerCase(final Request message) {
+ return new Response(message.getValue().toLowerCase());
+ }
+}
+----
+
+== Testando
+
+=== Teste para o serviço JAXRS
+
+O teste utiliza o OpenEJB ApplicationComposer para torná-lo trivial.
+
+A idea é primeiro ativar os serviços jaxrs. Isso é feito usando a
+anotação @EnableServices.
+
+Em seguida, criamos rapidamente o aplicativo, simplesmente retornando um objeto
+representando o web.xml. Aqui nós, simplesmente usamos isso para definir o contexto
+root, mas você pode usá-lo para definir sua Aplicação REST também. E para
+finalizar a definição da aplicação, nós adicionamos a anotação @Classes, para definir
+o grupo de classes para ser usado nessa aplicação.
+
+Finalmente para testá-lo, usamos a API cliente cxf, para chamar o serviço
+REST em métodos get() e post().
+
+Notação lateral: para mostrar que usamos JSON ou XML, dependendo no método de teste nós
Review comment:
The change is applied.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] jrxxjr commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
jrxxjr commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r476078692
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,398 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+#O Código
Review comment:
The change is applied.
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,398 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+#O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que utiliza a opção Concorrência Bean-Managed, bem
+como a anotação @Startup, que faz com que o bean seja instanciado pelo
+contêiner, enquanto a aplicação inicia. Beans Singleton com
+@ConcurrencyManagement(BEAN) são responsáveis por seus próprios
+thread-safety. O bean mostrado é uma simples ``registro'' de propriedade e
+provisiona um lugar onde opções podem ser definidas e recuperadas por todos os beans
+na aplicação.
Review comment:
The change is applied.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] hbelmiro commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
hbelmiro commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r477180557
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que usa as anotações @Path, @Produces e @Consumes.
+A anotação @Path identifica o modelo de caminho URI ao qual o recurso responde e é especificado no nível de classe de um recurso. O valor da anotação @Path
+é um modelo de caminho de URI parcial relativo ao URI de base do servidor no qual o recurso está implementado, a raiz de contexto do WAR e o padrão de URL
+para o qual o servlet auxiliar Jersey responde.
+A anotação @Produces é usada para especificar os tipos de mídia MIME ou representações que um recurso pode produzir e enviar de volta ao cliente. Se @Produces
+for aplicado no nível da classe, todos os métodos em um recurso podem produzir os tipos MIME especificados por padrão. Se for aplicado no nível de método, substitui
+quaisquer anotações @Produces aplicadas no nível da classe.
+A anotação @Consumes é usada para especificar quais tipos de mídia MIME de representações um recurso pode aceitar ou consumir do cliente. Se @Consumes for
+aplicado no nível da classe, todos os métodos de resposta aceitarão os tipos MIME especificados por padrão. Se @Consumes for aplicado no nível do método, ele
+substituirá qualquer @Consumes anotações aplicadas no nível da classe.
+
+Na realidade linhas:
+
+[código,java]
+----
+@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+----
+
+são opcionais, uma vez que é a configuração padrão. E essas linhas, podem
+ser configuradas pelo método também, se você precisar para ser mais preciso.
+
+[código,java]
+----
+@Path("/greeting")
+@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+public class GreetingService {
+ @GET
+ public Response message() {
+ return new Response("Hi REST!");
+ }
+
+ @POST
+ public Response lowerCase(final Request message) {
+ return new Response(message.getValue().toLowerCase());
+ }
+}
+----
+
+== Testando
+
+=== Teste para o serviço JAXRS
+
+O teste utiliza o OpenEJB ApplicationComposer para torná-lo trivial.
+
+A idea é primeiro ativar os serviços jaxrs. Isso é feito usando a
+anotação @EnableServices.
+
+Em seguida, criamos rapidamente o aplicativo, simplesmente retornando um objeto
+representando o web.xml. Aqui nós, simplesmente usamos isso para definir o contexto
+root, mas você pode usá-lo para definir sua Aplicação REST também. E para
+finalizar a definição da aplicação, nós adicionamos a anotação @Classes, para definir
+o grupo de classes para ser usado nessa aplicação.
+
+Finalmente para testá-lo, usamos a API cliente cxf, para chamar o serviço
+REST em métodos get() e post().
+
+Notação lateral: para mostrar que usamos JSON ou XML, dependendo no método de teste nós
Review comment:
Sorry. I was thinking that "SIDE NOTE" was a tag. IMHO, "Observação" is better.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] jrxxjr commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
jrxxjr commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r477003185
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que usa as anotações @Path, @Produces e @Consumes.
+A anotação @Path identifica o modelo de caminho URI ao qual o recurso responde e é especificado no nível de classe de um recurso. O valor da anotação @Path
+é um modelo de caminho de URI parcial relativo ao URI de base do servidor no qual o recurso está implementado, a raiz de contexto do WAR e o padrão de URL
+para o qual o servlet auxiliar Jersey responde.
+A anotação @Produces é usada para especificar os tipos de mídia MIME ou representações que um recurso pode produzir e enviar de volta ao cliente. Se @Produces
+for aplicado no nível da classe, todos os métodos em um recurso podem produzir os tipos MIME especificados por padrão. Se for aplicado no nível de método, substitui
+quaisquer anotações @Produces aplicadas no nível da classe.
+A anotação @Consumes é usada para especificar quais tipos de mídia MIME de representações um recurso pode aceitar ou consumir do cliente. Se @Consumes for
+aplicado no nível da classe, todos os métodos de resposta aceitarão os tipos MIME especificados por padrão. Se @Consumes for aplicado no nível do método, ele
+substituirá qualquer @Consumes anotações aplicadas no nível da classe.
+
+Na realidade linhas:
+
+[código,java]
+----
+@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+----
+
+são opcionais, uma vez que é a configuração padrão. E essas linhas, podem
+ser configuradas pelo método também, se você precisar para ser mais preciso.
+
+[código,java]
+----
+@Path("/greeting")
+@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+public class GreetingService {
+ @GET
+ public Response message() {
+ return new Response("Hi REST!");
+ }
+
+ @POST
+ public Response lowerCase(final Request message) {
+ return new Response(message.getValue().toLowerCase());
+ }
+}
+----
+
+== Testando
+
+=== Teste para o serviço JAXRS
+
+O teste utiliza o OpenEJB ApplicationComposer para torná-lo trivial.
+
+A idea é primeiro ativar os serviços jaxrs. Isso é feito usando a
+anotação @EnableServices.
+
+Em seguida, criamos rapidamente o aplicativo, simplesmente retornando um objeto
+representando o web.xml. Aqui nós, simplesmente usamos isso para definir o contexto
+root, mas você pode usá-lo para definir sua Aplicação REST também. E para
+finalizar a definição da aplicação, nós adicionamos a anotação @Classes, para definir
+o grupo de classes para ser usado nessa aplicação.
+
+Finalmente para testá-lo, usamos a API cliente cxf, para chamar o serviço
+REST em métodos get() e post().
+
+Notação lateral: para mostrar que usamos JSON ou XML, dependendo no método de teste nós
Review comment:
In portuguese do not use the word "Side Note", uses "Note" or "Observation", i made a mistake, in portuguese to say "Notação" or "Observação", and not "Notação lateral" as i wrote.
Do you like better, "Note"(Notação) or "Observation"(Observação) ?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] Daniel-Dos commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r468821246
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,398 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+#O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que utiliza a opção Concorrência Bean-Managed, bem
+como a anotação @Startup, que faz com que o bean seja instanciado pelo
+contêiner, enquanto a aplicação inicia. Beans Singleton com
+@ConcurrencyManagement(BEAN) são responsáveis por seus próprios
+thread-safety. O bean mostrado é uma simples ``registro'' de propriedade e
+provisiona um lugar onde opções podem ser definidas e recuperadas por todos os beans
+na aplicação.
Review comment:
the example described here does not reflect the current project code. Because it does not contain the elements described in the text. Here it is necessary to update to reflect the example and also to update the English version.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] Daniel-Dos merged pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
Daniel-Dos merged pull request #703:
URL: https://github.com/apache/tomee/pull/703
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] hbelmiro commented on a change in pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
hbelmiro commented on a change in pull request #703:
URL: https://github.com/apache/tomee/pull/703#discussion_r476320546
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
Review comment:
```suggestion
Definir um serviço REST é muito fácil, simplesmente adicionamos a anotação @Path na
```
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
Review comment:
```suggestion
classe, então definimos nos métodos, o método HTTP para usar (@GET, @POST, …).
```
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que usa as anotações @Path, @Produces e @Consumes.
+A anotação @Path identifica o modelo de caminho URI ao qual o recurso responde e é especificado no nível de classe de um recurso. O valor da anotação @Path
+é um modelo de caminho de URI parcial relativo ao URI de base do servidor no qual o recurso está implementado, a raiz de contexto do WAR e o padrão de URL
Review comment:
```suggestion
é um modelo de caminho de URI parcial relativo ao URI base do servidor no qual o recurso está implementado, o contexto raiz do WAR e o padrão de URL
```
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que usa as anotações @Path, @Produces e @Consumes.
+A anotação @Path identifica o modelo de caminho URI ao qual o recurso responde e é especificado no nível de classe de um recurso. O valor da anotação @Path
+é um modelo de caminho de URI parcial relativo ao URI de base do servidor no qual o recurso está implementado, a raiz de contexto do WAR e o padrão de URL
+para o qual o servlet auxiliar Jersey responde.
+A anotação @Produces é usada para especificar os tipos de mídia MIME ou representações que um recurso pode produzir e enviar de volta ao cliente. Se @Produces
+for aplicado no nível da classe, todos os métodos em um recurso podem produzir os tipos MIME especificados por padrão. Se for aplicado no nível de método, substitui
+quaisquer anotações @Produces aplicadas no nível da classe.
+A anotação @Consumes é usada para especificar quais tipos de mídia MIME de representações um recurso pode aceitar ou consumir do cliente. Se @Consumes for
+aplicado no nível da classe, todos os métodos de resposta aceitarão os tipos MIME especificados por padrão. Se @Consumes for aplicado no nível do método, ele
+substituirá qualquer @Consumes anotações aplicadas no nível da classe.
Review comment:
```suggestion
substituirá qualquer anotação @Consumes aplicada no nível da classe.
```
##########
File path: examples/rest-xml-json/README_pt.adoc
##########
@@ -0,0 +1,401 @@
+:index-group: Unrevised
+:jbake-type: page
+:jbake-status: status=published
+= REST Simples
+
+Definir um serviço REST é muito fácil, simplesmente anúncio a anotação @Path para a
+classe, então definir nos métodos, o método HTTP para usar (@GET, @POST, …).
+
+O Código
+
+== O serviço REST: @Path, @Produces, @Consumes
+
+Aqui nós vemos um bean que usa as anotações @Path, @Produces e @Consumes.
+A anotação @Path identifica o modelo de caminho URI ao qual o recurso responde e é especificado no nível de classe de um recurso. O valor da anotação @Path
+é um modelo de caminho de URI parcial relativo ao URI de base do servidor no qual o recurso está implementado, a raiz de contexto do WAR e o padrão de URL
+para o qual o servlet auxiliar Jersey responde.
+A anotação @Produces é usada para especificar os tipos de mídia MIME ou representações que um recurso pode produzir e enviar de volta ao cliente. Se @Produces
+for aplicado no nível da classe, todos os métodos em um recurso podem produzir os tipos MIME especificados por padrão. Se for aplicado no nível de método, substitui
+quaisquer anotações @Produces aplicadas no nível da classe.
+A anotação @Consumes é usada para especificar quais tipos de mídia MIME de representações um recurso pode aceitar ou consumir do cliente. Se @Consumes for
+aplicado no nível da classe, todos os métodos de resposta aceitarão os tipos MIME especificados por padrão. Se @Consumes for aplicado no nível do método, ele
+substituirá qualquer @Consumes anotações aplicadas no nível da classe.
+
+Na realidade linhas:
+
+[código,java]
+----
+@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+----
+
+são opcionais, uma vez que é a configuração padrão. E essas linhas, podem
+ser configuradas pelo método também, se você precisar para ser mais preciso.
+
+[código,java]
+----
+@Path("/greeting")
+@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+@Consumes({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
+public class GreetingService {
+ @GET
+ public Response message() {
+ return new Response("Hi REST!");
+ }
+
+ @POST
+ public Response lowerCase(final Request message) {
+ return new Response(message.getValue().toLowerCase());
+ }
+}
+----
+
+== Testando
+
+=== Teste para o serviço JAXRS
+
+O teste utiliza o OpenEJB ApplicationComposer para torná-lo trivial.
+
+A idea é primeiro ativar os serviços jaxrs. Isso é feito usando a
+anotação @EnableServices.
+
+Em seguida, criamos rapidamente o aplicativo, simplesmente retornando um objeto
+representando o web.xml. Aqui nós, simplesmente usamos isso para definir o contexto
+root, mas você pode usá-lo para definir sua Aplicação REST também. E para
+finalizar a definição da aplicação, nós adicionamos a anotação @Classes, para definir
+o grupo de classes para ser usado nessa aplicação.
+
+Finalmente para testá-lo, usamos a API cliente cxf, para chamar o serviço
+REST em métodos get() e post().
+
+Notação lateral: para mostrar que usamos JSON ou XML, dependendo no método de teste nós
Review comment:
```suggestion
SIDE NOTE: para mostrar que usamos JSON ou XML, dependendo no método de teste nós
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [tomee] Daniel-Dos commented on pull request #703: TOMEE-2895 Translate to Portuguese: examples/rest-xml-json
Posted by GitBox <gi...@apache.org>.
Daniel-Dos commented on pull request #703:
URL: https://github.com/apache/tomee/pull/703#issuecomment-683325751
thanks @jrxxjr and @hbelmiro
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org