让我们从这个简单的示例中逐步弄清楚 Seam 对象是怎样工作的。首先，我们创建一个名为 helloAction 的新的Seam组件。

@Stateless
@Name("helloAction")
public class HelloAction implements HelloLocal {
    public String sayHello(String name) {
        return "Hello, " + name;
    }
}

同时需要为这个新组件创建一个本地接口 —— 特别要注意 @WebRemote 注解，因为它是能远程访问我们方法所必须的。

@Local
public interface HelloLocal {
  @WebRemote
  public String sayHello(String name);
}

这是我们所编写的所有服务器端代码。接下来就是我们的Web页面 —— 创建一个新的页面然后引入以下脚本：

<s:remote include="helloAction"/>

为了完成一个完整的用户交互体验，我们增加一个按钮：

<button onclick="javascript:sayHello()">Say Hello</button>

同时，我们还需要增加更多脚本以使得按钮在被点击后真正能够做出相应的反应：

<script type="text/javascript">
  //<![CDATA[

  function sayHello() {
    var name = prompt("What is your name?");
    Seam.Component.getInstance("helloAction").sayHello(name, sayHelloCallback);
  }

  function sayHelloCallback(result) {
    alert(result);
  }

   // ]]>
</script>

到此已经全部完成了！部署这个应用程序并且浏览页面，点击按钮，按照提示输入一个名字，会出现一个hello消息框，这个消息框的出现表明了这次调用是成功的。 如果你想节省时间，你可以从Seam的 /examples/remoting/helloworld 目录中找到这个Hello World示例的所有源代码。

那我们的脚本到底做了什么呢？我们把它分解成更小的部分。 开始你可以从列出的JavaScript代码中看到我们已经实现了两个方法 —— 第一个方法负责提示用户输入姓名，然后产生一个远程请求。看一下下面这行：

Seam.Component.getInstance("helloAction").sayHello(name, sayHelloCallback);

这一行的第一部分 Seam.Component.getInstance("helloAction")，返回了一个代理，或者 helloAction 组件的存根。 我们可以通过这个存根调用组件的方法，这也是剩余部分即 sayHello(name, sayHelloCallback); 所做的事情。

这整行的代码是在调用我们组件的 sayHello 方法，并且传进来 name 作为参数。 第二个参数 sayHelloCallback 并不是我们组件的 sayHello 方法的参数， 相反它告诉Seam Remoting框架一旦它收到与请求对应的响应，则要把这个响应传递到JavaScript脚本的 sayHelloCallback 方法。 这个回调参数是完全可选的，因此当你调用一个返回值为 void 方法或者你不关心结果时，你可以不使用这个参数。

一旦 sayHelloCallback 方法收到了远程请求的响应，就会弹出一个警告消息，以显示方法调用的结果。

Seam.Component JavaScript对象提供了许多客户端方法来与Seam组件一起工作， 它的两个主要方法是 newInstance() 和 getInstance()，将在下面的小节中讲解， 它们的主要区别是 newInstance() 总是创建一个组件类型的新实例，而 getInstance() 却返回一个单例的实例。

@Name("customer")
@Entity
public class Customer implements Serializable
{
  private Integer customerId;
  private String firstName;
  private String lastName;

  @Column public Integer getCustomerId() {
    return customerId;
  }

  public void setCustomerId(Integer customerId} {
    this.customerId = customerId;
  }

  @Column public String getFirstName() {
    return firstName;
  }

  public void setFirstName(String firstName) {
    this.firstName = firstName;
  }

  @Column public String getLastName() {
    return lastName;
  }

  public void setLastName(String lastName) {
    this.lastName = lastName;
  }
}

var customer = Seam.Component.newInstance("customer");

customer.setFirstName("John");
// Or you can set the fields directly
customer.lastName = "Smith";

Seam.Component.getInstance("customerAction").saveCustomer(customer);

if (Seam.Component.getComponentName(instance) == "customer")
  alert("Customer");
else if (Seam.Component.getComponentName(instance) == "staff")
  alert("Staff member");

Seam Remoting相关的大多数客户端功能都包含在 Seam.Remoting 对象中。 你不必直接调用它的大多数方法，但是非常有必要解释一下两个非常重要的方法。

var widget = Seam.Remoting.createType("com.acme.widgets.MyWidget");

如果你打算在对话范围内使用远程调用，那么你需要能从Seam Remoting上下文中读取或者设置对话ID。 在发起远程请求调用 Seam.Remoting.getContext().getConversationId() 后读取对话ID。 在发起请求前通过调用 Seam.Remoting.getContext().setConversationId() 来设置对话ID。

如果对话ID没有通过 Seam.Remoting.getContext().setConversationId() 显式地进行设置， 那么它将自动地被赋值为任意远程调用返回的第一个有效的对话ID。如果你的页面有多个对话，那么你需要在每次调用之前显式地设置对话ID。 如果你只是工作于单个对话中，那么你不需要额外做任何事情。

在某些情况下，可能会要求在当前视图的对话范围内发起一个远程调用，为此，你必须要在调用之前显式地设置对话ID。 以下一小段JavaScript代码将在当前视图会话ID远程调用的时候，设置会话ID。

Seam.Remoting.getContext().setConversationId( #{conversation.id} );

这部分描述了基本数据类型的支持。一般来说，在服务器端这些值是与它们的原生类型或者相应的包装类相兼容的。

一般来说，JavaBean一般是Seam实体或者JavaBean组件，或者其他别的非组件类。 需要使用适当的方法（Seam组件使用 Seam.Component.newInstance()，其它使用 Seam.Remoting.createType()）来创建对象的新实例。

注意只有这两个方法创建的对象才能被用作参数值，这些参数值不是本节所提到的有效类型之一。在不能确定参数类型的情况下，你可以使用如下的组件方法：

@Name("myAction")
public class MyAction implements MyActionLocal {
  public void doSomethingWithObject(Object obj) {
    // code
  }
}

在这个示例中你可能要传进 myWidget 组件的一个实例，然而 myAction 接口并没有包含 myWidget，因为它并没有被它的任何方法直接引用。 为了能够把参数传进来，需要显式地引入 MyWidget：

<s:remote include="myAction,myWidget"/>

这允许使用 Seam.Component.newInstance("myWidget") 创建 myWidget 对象，并允许创建后的对象传递到 myAction.doSomethingWithObject() 中。

日期值被序列化成字符串表示，并且精确到毫秒。在客户端，使用JavaScript日期对象来使用日期值。 在服务器端，使用 java.util.Date 类（或者派生类，如 java.sql.Date 或 java.sql.Timestamp）。

在客户端，Enum也被作为String处理。当为Enum参数设置值时，简单地使用Enum的字符串表示就行了。以下面的组件为例：

@Name("paintAction")
public class paintAction implements paintLocal {
  public enum Color {red, green, blue, yellow, orange, purple};

  public void paint(Color color) {
    // code
  }
} 

为了调用 paint() 方法，并且传递给参数color的值是 red，只要把red作为字符串传入就可以了：

Seam.Component.getInstance("paintAction").paint("red");

反过来也是成立的 —— 也就是说，如果一个组件方法返回Enum型参数（或者返回的对象图里包含一个Enum字段），那么在客户端仍将被表示为一个字符串。

如果要把默认的“Please Wait...”消息改成其它内容，则需要设置 Seam.Remoting.loadingMessage 的值:

Seam.Remoting.loadingMessage = "Loading..."; 

如果要尽可能少的显示加载消息，可以通过覆写 displayLoadingMessage() 和 hideLoadingMessage() 的实现为反之不显示任何消息的函数：

// don't display the loading indicator
Seam.Remoting.displayLoadingMessage = function() {};
Seam.Remoting.hideLoadingMessage = function() {};

如果你需要覆写加载指示器以显示一个动画图标或者其他东西，那么你需要覆写 displayLoadingMessage() 和 hideLoadingMessage()。

  Seam.Remoting.displayLoadingMessage = function() {
    // Write code here to display the indicator
  };

  Seam.Remoting.hideLoadingMessage = function() {
    // Write code here to hide the indicator
  };

如果远程方法返回 Widget 实例，但你不想暴露 secret 字段，因为它包含一些敏感信息，你可以用如下的方式限制它：

@WebRemote(exclude = {"secret"})
public Widget getWidget(); 

值"secret"指向了返回对象的 secret 字段。现在假定我们不关心这个特殊字段会暴露给客户端。 相反，我们看到返回值 Widget 含有一个 child 字段，它也是 Widget。 我们该如何来隐藏 child 的值呢？我们可以在结果对象图中使用.号指定的字段路径来达到这个目的：

@WebRemote(exclude = {"child.secret"})
public Widget getWidget();

对象存在于一个对象图中的另一个方式是 Map 或者一些集合类（List、Set、Array 等等）。 集合类很简单，可以和其它别的字段一样来看待。例如如果 Widget 在它的 widgetList 字段里包含了一个 Widget 列表，为了限定这个列表中的 Widget 的 secret 字段的注解大概类似于这样：

@WebRemote(exclude = {"widgetList.secret"})
  public Widget getWidget();

如果要限定 Map 的键或者值，那么注解会有点不同。 在 Map 的字段名后面增加 [key] 将限定 Map 键对象，同时，[value] 将限定值对象。下面的例子描述了 widgetMap 字段怎么样限定了它们的 secret 字段：

@WebRemote(exclude = {"widgetMap[value].secret"})
public Widget getWidget(); 

还有一个注解可用来限定对象的字段，不管字段出现在结果对象图的哪个位置它都起作用。 这个注解既可以使用组件的名称（如果对象是一个Seam组件），也可以是一个完全限定的类名（仅当对象不是Seam组件时），并且是以[]的形式来限定的。

@WebRemote(exclude = {"[widget].secret"})
public Widget getWidget(); 

限定也可以合并，用多个路径对对象图中的对象进行过滤：

@WebRemote(exclude = {"widgetList.secret", "widgetMap[value].secret"})
public Widget getWidget();

为能够订阅JMS主题，你必须先配置一个可以通过Seam Remoting订阅的主题列表。 需要在seam.properties、web.xml 或者 components.xml 的 org.jboss.seam.remoting.messaging.subscriptionRegistry.allowedTopics 中列出所有的主题。

<remoting:remoting poll-timeout="5" poll-interval="1"/>

下面的例子说明了如何来订阅一个JMS主题：

function subscriptionCallback(message)
{
  if (message instanceof Seam.Remoting.TextMessage)
    alert("Received message: " + message.getText());
}

Seam.Remoting.subscribe("topicName", subscriptionCallback);

Seam.Remoting.subscribe()方法具有两个参数，第一个参数是可被订阅的JMS主题名，第二个参数是接收到一个消息时要调用的回调函数。

支持两种类型的消息：Text消息和Object消息。 若要测试传给回调函数的消息类型，你可以调用 instanceof 操作符来测试这个消息是 Seam.Remoting.TextMessage 还是 Seam.Remoting.ObjectMessage。 TextMessage 的 text 字段是文本值， ObjectMessage 的 object 字段（或者调用 getObject() 方法得到的）是对象值。

如果要取消一个主题的订阅，则需要调用 Seam.Remoting.unsubscribe()，并且传进这个主题的名称：

Seam.Remoting.unsubscribe("topicName");

你可以通过修改两个参数来控制轮询的发生方式。 第一个参数是Seam.Remoting.pollInterval，它控制新消息的并发轮询间隔。这个参数的单位是秒，默认值是10。

第二个参数是 Seam.Remoting.pollTimeout，它的单位也是秒。 它控制在超时和发送一个空的响应之前，发送到服务器端的请求等待新消息要等多久。 它的默认值是0秒，也就是说当服务器端被轮询到后，如果没有已经准备好的消息发送，则立即发送一个空的响应。

若要设置一个高的 pollTimeout 值，你应该非常谨慎；每一个请求都必须等待一个响应消息，也就是说服务器端线程在收到消息前，或者请求超时前是被阻塞的。 由于这个原因，如果很多请求同时被处理，会导致大量的线程被阻塞。

建议通过components.xml来设置这些选项，但是如果需要，也可以通过JavaScript来覆盖它们。 下面的例子说明了如何配置轮询以使得它更具侵略性。你应该在应用程序中为这些参数设置适当的值。

通过components.xml配置：

<remoting:remoting poll-timeout="5" poll-interval="1"/>

通过JavaScript配置：

// Only wait 1 second between receiving a poll response and sending the next poll request.
Seam.Remoting.pollInterval = 1;

// Wait up to 5 seconds on the server for new messages
Seam.Remoting.pollTimeout = 5;