From dev-return-26848-archive-asf-public=cust-asf.ponee.io@tomee.apache.org Mon Jul 6 14:38:33 2020 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id 8DD4318062C for ; Mon, 6 Jul 2020 16:38:33 +0200 (CEST) Received: (qmail 51954 invoked by uid 500); 6 Jul 2020 14:38:32 -0000 Mailing-List: contact dev-help@tomee.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@tomee.apache.org Delivered-To: mailing list dev@tomee.apache.org Received: (qmail 51941 invoked by uid 99); 6 Jul 2020 14:38:32 -0000 Received: from ec2-52-202-80-70.compute-1.amazonaws.com (HELO gitbox.apache.org) (52.202.80.70) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 06 Jul 2020 14:38:32 +0000 From: =?utf-8?q?GitBox?= To: dev@tomee.apache.org Subject: =?utf-8?q?=5BGitHub=5D_=5Btomee=5D_jrxxjr_commented_on_a_change_in_pull_requ?= =?utf-8?q?est_=23668=3A_Portuguese_translation_README=2Eadoc_file_examples/?= =?utf-8?q?webservice-ws-with-resources-config?= Message-ID: <159404631264.29655.14301954442763834759.asfpy@gitbox.apache.org> Date: Mon, 06 Jul 2020 14:38:32 -0000 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit In-Reply-To: References: 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] +---- + + + + + cxf.jaxws.in-interceptors = wss4j + + + +---- +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] +---- + + + + + action = UsernameToken + passwordType = PasswordText + passwordCallbackClass = org.superbiz.ws.security.PasswordCallbackHandler + + +---- +== 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