syncconduitbean.java

这个范例程序演示了利用j2me技术开发无线服务器支持的应用。这是一个电影票订购程序

/*
 * Copyright 2001, 2002, 2003 Sun Microsystems, Inc. All Rights Reserved.
 * Except for any files in PNG format (which are marked with the filename
 * extension ".png"), GIF format (which are marked with the filename
 * extension ".gif"), or JPEG format (which are marked with the filename
 * extension ".jpg"), redistribution and use in source and binary forms,
 * with or without modification, are permitted provided that the
 * following conditions are met:
 * - Redistribution of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 * - Redistribution in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 * You may compile, use, perform and display the following files with
 * original Java Smart Ticket Sample Application code obtained from Sun
 * Microsystems, Inc. only:
 * - files in PNG format and having the ".png" extension
 * - files in GIF format and having the ".gif" extension
 * - files in JPEG format and having the ".jpg" extension
 * You may not modify or redistribute .png, .gif, or .jpg files in any
 * form, in whole or in part, by any means without prior written
 * authorization from Sun Microsystems, Inc. and its licensors, if any.
 * Neither the name of Sun Microsystems, Inc., the 'Java Smart Ticket
 * Sample Application', 'Java', 'Java'-based names, or the names of
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 * This software is provided "AS IS," without a warranty of any kind. ALL
 * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES,
 * INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A
 * PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN
 * MIDROSYSTEMS, INC. ("SUN") AND ITS LICENSORS SHALL NOT BE LIABLE FOR
 * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
 * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR
 * ITS LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR
 * DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE
 * DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
 * ARISING OUT OF THE USE OF OR INABILITY TO USE THIS SOFTWARE, EVEN IF
 * SUN HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 * You acknowledge that this software is not designed, licensed or
 * intended for use in the design, construction, operation or maintenance
 * of any nuclear facility.
 * $Id: SyncConduitBean.java,v 1.5 2003/03/24 22:43:11 zull Exp $
 */
package com.sun.j2me.blueprints.smartticket.server.ejb.synchronizing;

import javax.ejb.*;
import java.util.*;
import java.util.Collection;
import com.sun.j2me.blueprints.smartticket.server.ejb.account.AccountLocal;

/**
 * @createTableDeploy
 * @ejbTransactionAttribute Required
 * @ejbLocalHome <{com.sun.j2me.blueprints.smartticket.server.ejb.synchronizing.SyncConduitLocalHome}>
 * @ejbLocal <{com.sun.j2me.blueprints.smartticket.server.ejb.synchronizing.SyncConduitLocal}>
 * @ejbDontSynchronizeNames
 * @ejbJNDIname ejb/smartticket/smartticket/SyncConduit
 * @ejbLocalJNDIname ejb/smartticket/smartticket/SyncConduit
 * @ejbAbstractSchemaName SyncConduit
 * @displayName SyncConduitEB
 * @deleteTableUndeploy
 * @undefined
 */
abstract public class SyncConduitBean implements EntityBean {
    private EntityContext ctx;

    /**
     * @shapeType EJBRelationshipLink
     * @relation_source <oiref:java#Member#com.sun.j2me.blueprints.smartticket.server.ejb.synchronizing.SyncConduitBean#getSyncMetaDataSet#(##)#:oiref>
     * @relation_destination <oiref:java#Member#com.sun.j2me.blueprints.smartticket.server.ejb.synchronizing.SyncMetaDataBean#getSyncConduit#(##)#:oiref>
     */
    /* #SyncMetaDataBean lnkSyncMetaDataBean; */
    public void setEntityContext(EntityContext context) throws EJBException {
        ctx = context;
    } 

    public void unsetEntityContext() throws EJBException {
        ctx = null;
    } 

    public void ejbActivate() throws EJBException {}

    public void ejbPassivate() throws EJBException {}

    public void ejbRemove() throws EJBException {}

    public void ejbStore() throws EJBException {}

    public void ejbLoad() throws EJBException {}

    public Object ejbCreate() throws CreateException {
        setNextClientId(0);

        return null;
    } 

    public void ejbPostCreate() throws CreateException {}

    /**
     * @multiplicity_type Collection
     * @CMP-Relationship
     * @CMP-Relationship-Destination com.sun.j2me.blueprints.smartticket.server.ejb.synchronizing.SyncMetaDataBean.syncConduit
     * @CMP-RelationshipEJBName-UNIDIR SyncMetaDataBean
     * @CMP-RelationshipMultiplicity one
     * @CMP-RelationshipRoleName SyncConduit to SyncMetaData
     * @CMP-RelationshipRoleName-UNIDIR UNIDIRECTIONAL SyncConduitBean
     * @relation_name SyncConduit-SyncMetaData
     */
    public abstract Collection getSyncMetaDataSet();
    public abstract void setSyncMetaDataSet(Collection param);

    /**
     * @multiplicity_type Collection
     * @CMP-Relationship
     * @CMP-Relationship-Destination com.sun.j2me.blueprints.smartticket.server.ejb.account.AccountBean.movieRatingSyncConduit
     * @CMP-RelationshipMultiplicity one
     * @relation_name Account-SyncConduit
     * @CMP-RelationshipRoleName SyncConduit to Account
     */
    public abstract AccountLocal getAccount();
    public abstract void setAccount(AccountLocal param);
    // XXX : Should use java.util.Set in the three following methods

    /**
     * @finder-query SELECT OBJECT(o) FROM SyncMetaData o  WHERE o.syncConduit.account.userName = ?1 and o.lastModificationTime > ?2
     */
    public abstract Collection ejbSelectSyncMetaDataChangedSince(String userName, 
            long time) throws FinderException;

    /**
     * @finder-query SELECT OBJECT(o) FROM SyncMetaData o  WHERE o.syncConduit.account.userName = ?1 and  o.deleted = TRUE and o.lastModificationTime > ?2
     */
    public abstract Collection ejbSelectSyncMetaDataDeletedSince(String userName, 
            long time) throws FinderException;

    /**
     * @finder-query SELECT OBJECT(o) FROM SyncMetaData o  WHERE o.syncConduit.account.userName = ?1 and  o.deleted = FALSE and o.lastModificationTime > ?2
     */
    public abstract Collection ejbSelectSyncMetaDataModifiedSince(String userName, 
            long time) throws FinderException;

    /**
     * @finder-query SELECT DISTINCT OBJECT(o) FROM SyncMetaData o  WHERE o.syncConduit.account.userName = ?1 and o.id = ?2
     */
    public abstract SyncMetaDataLocal ejbSelectSyncMetaData(String userName, 
            String id) throws FinderException;

    /**
     * @finder-query SELECT DISTINCT OBJECT(o) FROM SyncClient o  WHERE o.syncConduit.account.userName = ?1 and o.id = ?2
     */
    public abstract SyncClientLocal ejbSelectSyncClient(String userName, 
            int id) throws FinderException;
    public int makeSyncClientId() {
        int id = getNextClientId();

        setNextClientId(++id);

        return id;
    } 

    public Collection getChangedSyncMetaData(long time) {
        try {
            return ejbSelectSyncMetaDataChangedSince(getAccount().getUserName(), 
                                                     time);
        } catch (FinderException fe) {
            return null;
        } 
    } 

    public Collection getModifiedSyncMetaData(long time) {
        try {
            return ejbSelectSyncMetaDataDeletedSince(getAccount().getUserName(), 
                                                     time);
        } catch (FinderException fe) {
            return null;
        } 
    } 

    public Collection getDeletedSyncMetaData(long time) {
        try {
            return ejbSelectSyncMetaDataModifiedSince(getAccount().getUserName(), 
                                                      time);
        } catch (FinderException fe) {
            return null;
        } 
    } 

    public SyncMetaDataLocal getSyncMetaData(String id) {
        try {
            return ejbSelectSyncMetaData(getAccount().getUserName(), id);
        } catch (FinderException fe) {
            return null;
        } 
    } 

    public SyncClientLocal getSyncClient(int id) {
        try {
            return ejbSelectSyncClient(getAccount().getUserName(), id);
        } catch (FinderException fe) {
            return null;
        } 
    } 

    public abstract int getNextClientId();
    public abstract void setNextClientId(int param);

    /**
     * @multiplicity_type Collection
     * @CMP-Relationship
     * @CMP-Relationship-Destination com.sun.j2me.blueprints.smartticket.server.ejb.synchronizing.SyncClientBean.syncConduit
     * @CMP-RelationshipMultiplicity one
     * @CMP-RelationshipRoleName SyncConduit to SyncClient
     * @relation_name SyncConduit-SyncClient
     */
    public abstract Collection getSyncClients();
    public abstract void setSyncClients(Collection param);
}