Seam における 2 つの中心的概念は、 コンテキスト の概念と コンポーネント の概念です。 コンポーネントは、ステートフルなオブジェクト、通常は EJB です。 コンポーネントのインスタンスは、コンテキストと関連づけられ、そのコンテキスト中で名前を与えられます。 バイジェクション (Bijection) は、内部のコンポーネント名 (インスタンス変数) をコンテキスト中の名前にエイリアスし、 Seam によるコンポーネントツリーの動的な組み立て、再組み立てを可能にするメカニズムを提供します。

Seam に組み込まれたコンテキストから説明を始めましょう。

User user = (User) Contexts.getSessionContext().get("user");

Contexts.getSessionContext().set("user", user);

@Stateless

@Interceptors(SeamInterceptor.class)

public class LoginAction implements Login { 

    ... 

}

<interceptors>

   <interceptor>

      <interceptor-class

>org.jboss.seam.ejb.SeamInterceptor</interceptor-class>

   </interceptor>

</interceptors>

   

<assembly-descriptor>

   <interceptor-binding>

      <ejb-name

>*</ejb-name>

      <interceptor-class

>org.jboss.seam.ejb.SeamInterceptor</interceptor-class>

   </interceptor-binding>

</assembly-descriptor

>

@Name("loginAction")

@Stateless

public class LoginAction implements Login { 

    ... 

}

@Name("com.jboss.myapp.loginAction")

@Stateless

public class LoginAction implements Login { 

    ... 

}

<h:commandButton type="submit" value="Login"

                 action="#{com.jboss.myapp.loginAction.login}"/>

<factory name="loginAction" scope="STATELESS" value="#{com.jboss.myapp.loginAction}"/>

<components xmlns="http://jboss.com/products/seam/components">
    
    <import>org.jboss.seam.core</import>
    <import>org.jboss.seam.cache</import>
    <import>org.jboss.seam.transaction</import>
    <import>org.jboss.seam.framework</import>
    <import>org.jboss.seam.web</import>
    <import>org.jboss.seam.faces</import>
    <import>org.jboss.seam.international</import>
    <import>org.jboss.seam.theme</import>
    <import>org.jboss.seam.pageflow</import>
    <import>org.jboss.seam.bpm</import>
    <import>org.jboss.seam.jms</import>
    <import>org.jboss.seam.mail</import>
    <import>org.jboss.seam.security</import>
    <import>org.jboss.seam.security.management</import>  
    <import>org.jboss.seam.security.permission</import>
    <import>org.jboss.seam.captcha</import>
    <import>org.jboss.seam.excel.exporter</import>
    <!-- ... --->
</components>

@Name("user")

@Entity

@Scope(SESSION)

public class User { 

    ... 

}

@Name("user")

@Entity

@Scope(CONVERSATION)

@Role(name="currentUser", scope=SESSION)

public class User { 

    ... 

}

@Name("user")

@Entity

@Scope(CONVERSATION)

@Roles({@Role(name="currentUser", scope=SESSION),

        @Role(name="tempUser", scope=EVENT)})

public class User { 

    ... 

}

FacesMessages.instance().add("Welcome back, #{user.name}!");

@Name("loginAction")

@Stateless

public class LoginAction implements Login { 

    @In User user;

    ... 

}

@Name("loginAction")

@Stateless

public class LoginAction implements Login { 

    User user;

    

    @In

    public void setUser(User user) {

        this.user=user;

    }

    

    ... 

}

@Name("loginAction")

@Stateless

public class LoginAction implements Login { 

    @In("#{user.username}") String username;

    ... 

}

@Name("loginAction")

@Stateless

public class LoginAction implements Login { 

    @Out User user;

    ... 

}

@Name("loginAction")

@Stateless

public class LoginAction implements Login { 

    User user;

    

    @Out

    public User getUser() {

        return user;

    }

    

    ... 

}

@Name("loginAction")

@Stateless

public class LoginAction implements Login { 

    @In @Out User user;

    ... 

}

@Name("loginAction")

@Stateless

public class LoginAction implements Login { 

    User user;

    

    @In

    public void setUser(User user) {

        this.user=user;

    }

    

    @Out

    public User getUser() {

        return user;

    }

    

    ... 

}

@Name("messageSender") 

public class MessageSender {

    public void sendMessage() {

        //do something with JMS

    }

}

@Name("messageSender") 

@Install(precedence=MOCK)

public class MockMessageSender extends MessageSender {

    public void sendMessage() {

        //do nothing!

    }

}

private static final Log log = LogFactory.getLog(CreateOrderAction.class);

        

public Order createOrder(User user, Product product, int quantity) {

    if ( log.isDebugEnabled() ) {

        log.debug("Creating new order for user: " + user.username() + 

            " product: " + product.name() 

            + " quantity: " + quantity);

    }

    return new Order(user, product, quantity);

}

@Logger private Log log;

        

public Order createOrder(User user, Product product, int quantity) {

    log.debug("Creating new order for user: #0 product: #1 quantity: #2", user.username(), product.name(), quantity);

    return new Order(user, product, quantity);

}

@Logger private Log log;

        

public Order createOrder(User user, Product product, int quantity) {

    log.debug("Creating new order for user: #{user.username} product: #{product.name} quantity: #0", quantity);

    return new Order(user, product, quantity);

}

@Name("account")

public class Account extends AbstractMutable

{

    private BigDecimal balance;

    

    public void setBalance(BigDecimal balance)

    {

        setDirty(this.balance, balance);

        this.balance = balance;

    }

    

    public BigDecimal getBalance()

    {

        return balance;

    }

    

    ...

    

}

@Name("account")

public class Account

{

    private BigDecimal balance;

    

    public void setBalance(BigDecimal balance)

    {

        this.balance = balance;

    }

    

    @ReadOnly

    public BigDecimal getBalance()

    {

        return balance;

    }

    

    ...

    

}

@Stateful

@Name("account")

public class AccountManager extends AbstractMutable

{

    private Account account; // an entity bean

    

    @Unwrap

    public Account getAccount()

    {

        return account;

    }

    

    ...

    

}

@Factory(scope=CONVERSATION)

public List<Customer

> getCustomerList() { 

    return ... ;

} 

@DataModel List<Customer

> customerList;


@Factory("customerList")

public void initCustomerList() { 

    customerList = ...  ;

} 

@Name("customerList")

@Scope(CONVERSATION)

public class CustomerListManager

{

    ...

    

    @Unwrap

    public List<Customer

> getCustomerList() { 

        return ... ;

    }

}

@Name("hens")

@Scope(APPLICATION) 

public class HenHouse

{

    Set<Hen> hens;

    

    @In(required=false) Hen hen;

    

    @Unwrap

    public List<Hen> getHens()

    {

        if (hens == null)

        {

            // Setup our hens

        }

        return hens;

    }

    

    @Observer({"chickBorn", "chickenBoughtAtMarket"})

    public addHen()

    {

        hens.add(hen);

    }

    

    @Observer("chickenSoldAtMarket")

    public removeHen()

    {

        hens.remove(hen);

    }

    

    @Observer("foxGetsIn")

    public removeAllHens()

    {

        hens.clear();

    }

    ...

}