> For the complete documentation index, see [llms.txt](https://pauloricmarinho.gitbook.io/desenvolvimento/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pauloricmarinho.gitbook.io/desenvolvimento/webservices/gerando-webservices-com-jax-ws.md).

# Web Services com JAX-WS

![](/files/-MJrYULIR7aCpz6ym9D8)

A Java XML API for Web Services (JAX-WS) é uma biblioteca de Web Services para Java, que permite implementar serviços baseados nas normas XSD, WSDL e SOAP. A JAX-WS define o mapeamento de WSDL para Java e vice-versa. Com a JAX-WS é possível implementar Web Services partindo de um contrato WSDL ou partindo de código Java. Com a JAX-WS é também possível criar código cliente de invocação de Web Services.

![Modelo Cliente / Servidor JAX-WS em SOAP ](/files/-MJrW_xclFJpBrMM6exT)

**Implementando o Endpoint do Serviço**

![Estrutura Endpoint no Eclipse](/files/-MJrX0Hb4P1lB8zyf4IR)

Para implementação da classe de serviço utilizaremos as anotações *@WebService* e *@WebMethod* do pacote javax.

```java
package service;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;

@WebService
public class WsServidor {

	@WebMethod
	public String exibirVersao() {

		return "Web Service com JAX-WS, versão 1.0";
	}
	@WebMethod
	public String retornarString(@WebParam(name = "msg") String msg) {

		return "echo :: " + msg;
	}
	@WebMethod
	public Double retornarSoma(@WebParam(name = "valor1") Double x,
			@WebParam(name = "valor2") Double y) {

		return x + y;
	}
}
```

**@WebService :** representa uma interface ou classe de serviço.

**@WebMethod:** representa os métodos de uma interface de serviço.

**@WebParam:** representa os parâmetros de um método.

**Gerando os artefatos do Serviço**

Para gerar os artefatos do Serviço utilizaremos a ferramenta **wsgen**. Execute os comandos do wsgen apontado pro diretório raiz do projeto.

```bash
wsgen -s src -d src -cp build\classes -keep service.WsServidor
```

Para gerar com o WSDL, ServicePort e ServiceName use o comando a seguir, digite tudo em uma única linha

```bash
wsgen -s src -d src -cp build\classes -wsdl -r wsdl -keep 
-portname "{http://jaxWsServidor/}JaxWsServidorPort" 
-servicename "{http://jaxWsServidor/}JxWsServidorService" 
service.WsServidor
```

Depois de gerados os artefatos com o wsgen o projeto deverá ficar com seguinte estrutura:

![](/files/-MJrXxNh9mN7Uqr91IDe)

**Publicando o EndPoint do Serviço**

Para publicar o Serviço, criaremos uma classe com o publicador do endpoint.

```java
package service;

import javax.xml.ws.Endpoint;

public class PublicadorWsServidor {

	public static void main(String[] args) {		
		WsServidor servidor = new WsServidor();
		Endpoint.publish("http://localhost:8080/WsServidor/service", servidor);
		System.out.println("Servidor Publicado: http://localhost:8080/WsServidor/service");		
	}
}
```

 Para visualizar execute main para publicar o Serviço e digite em seu navegador: [*http://localhost:8080/WsServidor/service*](http://localhost:8080/WsServidor/service)**.**