tomee-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From GitBox <...@apache.org>
Subject [GitHub] [tomee] jrxxjr commented on a change in pull request #668: Portuguese translation README.adoc file examples/webservice-ws-with-resources-config
Date Mon, 06 Jul 2020 14:38:32 GMT

jrxxjr commented on a change in pull request #668:
URL: https://github.com/apache/tomee/pull/668#discussion_r450267281



##########
File path: examples/webservice-ws-with-resources-config/README_pt.adoc
##########
@@ -0,0 +1,86 @@
+:index-group: Webservice
+:jbake-type: page
+:jbake-status: published
+= Webservice JAX-WS - Configuração de Recursos
+
+TomEE conta com o Apache CXF para JAX-RS (RESTful Services) e JAX-WS (Web Services). Este
é um exemplo de como desenvolver EJB webservices graças a implementação CXF.
+
+== openejb-jar.xml Configuração
+Você pode usar (http://tomee.apache.org/details-on-openejb-jar.html[openejb-jar.xml]) para
configurar seu webservice.
+
+CXF API é reutilizável mas além disso você pode configurar os interceptadores através
do `openejb-jar.xml`(localizados na WEB-INF).
+Como um rápido lembrete, a configuração no `openejb-jar.xml`, você pode utilizar uma
configuração parecida a esta, com o seu próximo EJB:
+
+[source,xml]
+----
+
+<openejb-jar xmlns="http://www.openejb.org/openejb-jar/1.1">
+  <ejb-deployment ejb-name="CalculatorBean"> <!-- configurar os valores do bean,
no resources.xml -->
+    <properties>
+      cxf.jaxws.in-interceptors = wss4j
+    </properties>
+  </ejb-deployment>
+</openejb-jar>
+----
+Para um webservice Pojo isto é o mesmo, mas usando o pojo-deployment em vez do ejb-deployment.
+
+Então uma vez que fez sua seleção de prefixo, e conhece onde é para escrever a configuração,
basta utilizar as seguintes entradas:
+
+* *properties*: propriedades da fábrica servidora
+
+* *features*: CXF para características
+
+* *in-interceptors*: CXF dentro do interceptadores
+
+* *out-interceptors*: CXF fora dos interceptadores
+
+* *in-fault-interceptors*: CXF dentro dos interceptadores para tratamento de erros 
+
+* *out-fault-interceptors*: CXF fora dos out interceptadores para tratamento de erros 
+
+* *databinding*: servidor de vinculação de dados
+
+* *providers (somente para JAX-RS endpoint)*: lista de provedores JAX-RS
+
+* *skip-provider-scanning (somente para JAX-RS)*: utilizar ou não um provedor de varredura
(por padrão true)
+
+Para características de interceptadores, a regra é o mesma: lista de valores separados
por vírgula. Cada valor da lista, é um nome de classe qualificado ou um id de serviço,
é um ou o outro, no resources.xml.
+
+== Exemplo para JAX-WS
+Para configurar o WSS4J no EJB `CalculatorBean` para adicionar uma instância no openejb-jar.xml:
+
+[source,xml]
+----
+
+<resources>
+  <!-- os interceptadores -->
+  <Service id="wss4j1" class-name="org.apache.openejb.server.cxf.config.WSS4JInInterceptorFactory"
factory-name="create">
+    action = UsernameToken
+    passwordType = PasswordText
+    passwordCallbackClass = org.superbiz.ws.security.PasswordCallbackHandler
+  </Service>
+</resources>
+----
+== passwordCallbackClass
+
+`passwordCallbackClass` é uma propriedade do `WSS4JInInterceptorFactory` e seu valor da
classe é `PasswordCallbackHandler`.
+
+`PasswordCallbackHandler` utiliza `org.apache.wss4j.common.ext.WSPasswordCallback` para prover
senhas no mecanismo de callback.
+
+
+==== Exemplo
+
+Exemplo completo pode ser encontrado https://github.com/apache/tomee/blob/master/examples/webservice-ws-with-resources-config/src/main/java/org/superbiz/ws/security/PasswordCallbackHandler.java[aqui]:
+
+
+=== Executando os testes
+
+Exemplo de projeto completo pode ser encontrado https://github.com/apache/tomee/tree/master/examples/webservice-ws-with-resources-config[aqui].
+Isoe é um projeto maven, e todos os testes pode ser executados rodando o comando `mvn clean
test`.

Review comment:
       I am make a mistake, writed with error in the beginning sentence, "Isoe é", the correct
is "Isso é". But can be "Isto é" or "Este é", but not "Ele é", because "maven" is not
a person, this is a thing.




----------------------------------------------------------------
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



Mime
View raw message