hbelmiro commented on a change in pull request #691: URL: https://github.com/apache/tomee/pull/691#discussion_r457673774
########## File path: examples/pojo-webservice/README_pt.adoc ########## @@ -0,0 +1,297 @@ +:index-group: Web Services +:jbake-type: page +:jbake-status: status=published += Exemplo JAX-WS @WebService + +Criar serviços da Web com JAX-WS é bastante fácil. Pouco é preciso ser feito, além de anotar uma classe com `@WebService`. Este exemplo mostra o uso do CDI com anotação de webservice. O `web.xml` expõe o servlet de webservice no endereço `http://latexmath:[${host}:$]\{port}/ pojo-webservice?Wsdl`. Para executar o exemplo, você pode usar o plugin mavne do tomee, `mvn tomee:run`. Review comment: ```suggestion Criar serviços da Web com JAX-WS é bastante fácil. Pouco é preciso ser feito, além de anotar uma classe com `@WebService`. Este exemplo mostra o uso do CDI com anotação de webservice. O `web.xml` expõe o servlet de webservice no endereço `http://latexmath:[${host}:$]\{port}/ pojo-webservice?Wsdl`. Para executar o exemplo, você pode usar o plugin maven do tomee, `mvn tomee:run`. ``` ########## File path: examples/pojo-webservice/README_pt.adoc ########## @@ -0,0 +1,297 @@ +:index-group: Web Services +:jbake-type: page +:jbake-status: status=published += Exemplo JAX-WS @WebService + +Criar serviços da Web com JAX-WS é bastante fácil. Pouco é preciso ser feito, além de anotar uma classe com `@WebService`. Este exemplo mostra o uso do CDI com anotação de webservice. O `web.xml` expõe o servlet de webservice no endereço `http://latexmath:[${host}:$]\{port}/ pojo-webservice?Wsdl`. Para executar o exemplo, você pode usar o plugin mavne do tomee, `mvn tomee:run`. + +== web.xml + +Expor um servlet para o webservice + +[source,xml] +---- +<web-app xmlns="http://java.sun.com/xml/ns/javaee"; + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; + xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"; + version="3.0"> +<servlet> + <servlet-name>ws</servlet-name> + <servlet-class>org.superbiz.ws.pojo.PojoWS</servlet-class> +</servlet> +<servlet-mapping> + <servlet-name>ws</servlet-name> + <url-pattern>/*</url-pattern> +</servlet-mapping> +</web-app> +---- + +== @PojoWS + +Esta é a única classe concreta anotada como `@WebService` que expõe uma operação `ws()`, também o `WebServiceContext` e `UserTransaction` são injetados na classe e usados na operação. + +[source,java] +---- +import javax.annotation.Resource; +import javax.jws.WebService; +import javax.transaction.UserTransaction; +import javax.xml.ws.WebServiceContext; + +@WebService +public class PojoWS implements WS { + + @Resource + private WebServiceContext webServiceContext; + + @Resource + private UserTransaction userTransaction; + + @Override + public String ws() { + return webServiceContext + " & " + userTransaction; + } + + public void setWebServiceContext(WebServiceContext webServiceContext) { + this.webServiceContext = webServiceContext; + } + + public void setUserTransaction(UserTransaction userTransaction) { + this.userTransaction = userTransaction; + } +} +---- + +== @WebService Endpoint Interface + +Ter uma interface de endpoint não é necessário, mas pode facilitar muito o teste e o uso do webservice de outros clientes Java. + +[source,java] +---- +import javax.jws.WebService; + +@WebService +public interface WS { + + String ws(); +} +---- + +== PojoWS WSDL + +O wsdl para nosso serviço é criado automaticamente para nós e disponível em Review comment: ```suggestion O wsdl para nosso serviço é criado automaticamente para nós e está disponível em ``` ---------------------------------------------------------------- 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: us...@infra.apache.org
