24.2. 创建 SEI
概述
服务端点接口 (SEI)是 Java 代码的一部分，在服务实施和在该服务上发出请求的用户之间共享。SEI 定义服务实施的方法，并提供有关如何将服务公开为端点的详细信息。从 WSDL 合同开始，SEI 由代码生成器生成。但是，从 Java 开始时，开发人员负责创建 SEI。 创建 SEI 有两种基本模式：
绿色字段开发 - 在这个模式中，您正在没有现有 Java 代码或 WSDL 的情况下开发新服务。最好先创建 SEI。然后，您可以将 SEI 分发给负责实施使用 SEI 的服务提供商和消费者的任何开发人员。
注意推荐执行绿色字段服务开发方式，即首先创建一个定义服务及其接口的 WSDL 合同。请参阅 第 26 章 启动点 WSDL 合同。
服务启用 - 在这种模式中，您通常具有作为 Java 类实施的现有功能集合，并且您希望启用该服务。这意味着您必须执行两个操作：
- 创建一个 SEI，仅包含 作为服务一部分公开的操作。
修改现有的 Java 类，使其实施 SEI。
注意虽然您可以将 JAX-WS 注解添加到 Java 类中，但不推荐这样做。
编写接口
SEI 是标准的 Java 接口。它定义了类实施的一组方法。它还可以定义多个成员字段，以及实施类可访问的常量。
如果定义的方法为 SEI，应当映射到服务公开的操作。SEI 对应于 wsdl:portType 元素。SEI 定义的方法对应于 元素。
wsdl: portType
JAX-WS 定义了一个注解，允许您指定没有公开为服务一部分的方法。但是，最佳实践是将这些方法离开 SEI。
例 24.1 “简单 SEI” 为库存更新服务显示简单的 SEI。
例 24.1. 简单 SEI
package com.fusesource.demo;
public interface quoteReporter
{
public Quote getQuote(String ticker);
}实现接口
因为 SEI 是标准的 Java 接口，所以实施它的类是标准的 Java 类。如果以 Java 类开头，您必须进行修改以实施接口。如果您从 SEI 开始，实施类将实施 SEI。
例 24.2 “简单实施类” 显示在 例 24.1 “简单 SEI” 中实现接口的类。
例 24.2. 简单实施类
package com.fusesource.demo;
import java.util.*;
public class stockQuoteReporter implements quoteReporter
{
...
public Quote getQuote(String ticker)
{
Quote retVal = new Quote();
retVal.setID(ticker);
retVal.setVal(Board.check(ticker));[1]
Date retDate = new Date();
retVal.setTime(retDate.toString());
return(retVal);
}
}