listworkitemconsumer.java

日常的办公系统 应用工作流框架等增加员工的基本信息、培训信息、奖罚信息、薪资信息

/*
 * Copyright (c) 2005, John Mettraux, OpenWFE.org
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without 
 * modification, are permitted provided that the following conditions are met:
 * 
 * . Redistributions of source code must retain the above copyright notice, this
 *   list of conditions and the following disclaimer.  
 * 
 * . Redistributions 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.
 * 
 * . Neither the name of the "OpenWFE" nor the names of its contributors may be
 *   used to endorse or promote products derived from this software without
 *   specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
 * POSSIBILITY OF SUCH DAMAGE.
 *
 * $Id: ListWorkItemConsumer.java,v 1.24 2005/05/17 16:41:03 jmettraux Exp $
 */

//
// ListWorkItemConsumer.java
//
// [e-mail]
//
// generated with 
// jtmpl 1.0.04 20.11.2001 John Mettraux ([e-mail])
//

package openwfe.org.worklist;

import openwfe.org.OpenWfeException;
import openwfe.org.xml.XmlUtils;
import openwfe.org.engine.listen.AbstractWorkItemConsumer;
import openwfe.org.engine.workitem.WorkItem;
import openwfe.org.engine.workitem.CancelItem;
import openwfe.org.engine.workitem.InFlowWorkItem;
import openwfe.org.worklist.store.WorkItemStore;


/**
 * A workitem consumer for a worklist. 
 * Takes any input workitem and gives them to the current workitem store.
 *
 * <p><font size=2>CVS Info :
 * <br>$Author: jmettraux $
 * <br>$Date: 2005/05/17 16:41:03 $
 * <br>$Id: ListWorkItemConsumer.java,v 1.24 2005/05/17 16:41:03 jmettraux Exp $ </font>
 *
 * @author [e-mail]
 */
public class ListWorkItemConsumer

    extends AbstractWorkItemConsumer

{

    private final static org.apache.log4j.Logger log = org.apache.log4j.Logger
        .getLogger(ListWorkItemConsumer.class.getName());

    //
    // FIELDS

    //
    // CONSTRUCTORS

    //
    // METHODS

    /**
     * This method looks at the wi and either reply to the corresponding
     * ParticipantExpression either launch a new wf.
     */
    public Object use (final WorkItem wi)
        throws OpenWfeException
    {
        //
        // we don't want launch items here

        if ( ! (wi instanceof CancelItem))
            // InFlowWorkitem extends CancelItem...
        {
            throw new OpenWfeException
                ("Worklists don't accept launch items.");
        }

        log.debug
            ("use() Received a workitem of class '"+wi.getClass().getName()+
             "' for '"+((CancelItem)wi).getLastExpressionId()+"'");

        //
        // find a store that accepts our participant

        final WorkItemStore store = determineStore((CancelItem)wi);

        log.debug("use() workitem given to store '"+store.getName()+"'");
        
        //
        // store

        if (wi instanceof InFlowWorkItem)
            store.store((InFlowWorkItem)wi);
        else
            store.cancel((CancelItem)wi);

        //
        // no particular reply

        return null;
    }

    /**
     * Determines into which store workitems should go.
     */
    protected WorkItemStore determineStore (final CancelItem item)
    {
        WorkItemStore store = null;

        final String participantName = item.getParticipantName();

        //final ServiceIterator si = getContext()
        //    .serviceIterator(Definitions.STORE_ITERATOR);
        //final java.util.Iterator it = si.iterator();
        
        final java.util.Iterator it = 
            getContext().itemsOfClass(WorkItemStore.class).iterator();

        while (it.hasNext())
        {
            final WorkItemStore s = (WorkItemStore)it.next();

            if (s.acceptsWorkItemsFor(participantName))
            {
                return s;
            }

            //if ( ! it.hasNext())
            //    //
            //    // default store
            //{
            //    store = s;
            //}

            if (s.isDefaultStore()) store = s;
        }

        return store; // default
    }

    //
    // METHODS from Service

    public org.jdom.Element getStatus ()
    {
        org.jdom.Element result = new org.jdom.Element(getName());

        result.addContent(XmlUtils.getClassElt(this));
        result.addContent(XmlUtils.getRevisionElt("$Id: ListWorkItemConsumer.java,v 1.24 2005/05/17 16:41:03 jmettraux Exp $"));

        return result;
    }

}