genericwebeventprocessor.java

国外的一套开源CRM

     * @param userInfo 
     * @param uiWebScreenSection 
     * @param request 
     * @param response 
     * @param delegator 
     * @param eventProcessor 
     * @param dataMatrix 
     * @param primaryEntityName 
     * @param retrieveMethod 
     * @param fields 
     * @param orderBy 
     * @param queryInfo  criteria to be used in search 
     * @param relatedSearchClauses 
     * @param queryId 
     *
     * @return 
     */
    protected int preRetrieve(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor, DataMatrix dataMatrix,
        String primaryEntityName, int retrieveMethod, HashMap fields,
        ArrayList orderBy, QueryInfo queryInfo, List relatedSearchClauses,
        String queryId) {
        return STATUS_CONTINUE;
    }

    /**
     * DOCUMENT ME!
     *
     * @param userInfo 
     * @param uiWebScreenSection 
     * @param request 
     * @param response 
     * @param delegator 
     * @param eventProcessor 
     * @param dataMatrix 
     * @param primaryEntityName 
     * @param retrieveMethod 
     * @param fields 
     * @param orderBy 
     * @param queryInfo  criteria to be used in search 
     * @param relatedSearchClauses 
     * @param queryId 
     *
     * @return 
     *
     * @throws GenericEntityException 
     */
    protected int retrieve(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor, DataMatrix dataMatrix,
        String primaryEntityName, int retrieveMethod, HashMap fields,
        ArrayList orderBy, QueryInfo queryInfo, List relatedSearchClauses,
        String queryId) throws GenericEntityException {

        return eventProcessor.processRetrieve(userInfo, primaryEntityName,
            retrieveMethod, fields, orderBy, queryInfo,
            relatedSearchClauses, delegator, dataMatrix);
    }

    /**
     * DOCUMENT ME!
     *
     * @param userInfo 
     * @param uiWebScreenSection 
     * @param request 
     * @param response 
     * @param delegator 
     * @param eventProcessor 
     * @param dataMatrix 
     * @param primaryEntityName 
     * @param retrieveMethod 
     * @param fields 
     * @param orderBy 
     * @param queryInfo  criteria to be used in search 
     * @param relatedSearchClauses 
     * @param queryId 
     *
     * @return 
     */
    protected int postRetrieve(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor, DataMatrix dataMatrix,
        String primaryEntityName, int retrieveMethod, HashMap fields,
        ArrayList orderBy, QueryInfo queryInfo, List relatedSearchClauses,
        String queryId) {
        return STATUS_CONTINUE;
    }

    //-------------------------------------------------------------------------
    // UPDATE - Updates a set of entities in the data base.
    //-------------------------------------------------------------------------
    protected int processUpdate(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor, DataMatrix dataMatrix,
        UICache uiCache) throws GenericEntityException {
        UtilTimer timer = new UtilTimer();

        if (TIMER) {
            timer.timerString(1,
                "[GenericWebEventProcessor.processUpdate] Start");
        }

        int status = STATUS_CONTINUE;

        // Pre fill the data matrix from the info entered on the screen.
        dataMatrix.fillFromHtml(request, uiWebScreenSection);

        if (TIMER) {
            timer.timerString(1,
                "[GenericWebEventProcessor.processUpdate] Filled data matrix");
        }

        // Trigger the pre-update event.
        status = this.preUpdate(userInfo, uiWebScreenSection, request,
                response, delegator, eventProcessor, dataMatrix, uiCache);

        if (status != STATUS_CONTINUE) {
            return status;
        }

        if (TIMER) {
            timer.timerString(1,
                "[GenericWebEventProcessor.processUpdate] Preupdate finished");
        }

        // Trigger the update event.
        status = this.update(userInfo, uiWebScreenSection, request, response,
                delegator, eventProcessor, dataMatrix, uiCache);

        if (status != STATUS_CONTINUE) {
            return status;
        }

        if (TIMER) {
            timer.timerString(1,
                "[GenericWebEventProcessor.processUpdate] Update finished");
        }

        // Trigger the post-update event.
        status = this.postUpdate(userInfo, uiWebScreenSection, request,
                response, delegator, eventProcessor, dataMatrix, uiCache);

        if (TIMER) {
            timer.timerString(1,
                "[GenericWebEventProcessor.processUpdate] Postupdate finished");
        }

        return status;
    }

    /**
     * DOCUMENT ME!
     *
     * @param userInfo 
     * @param uiWebScreenSection 
     * @param request 
     * @param response 
     * @param delegator 
     * @param eventProcessor 
     * @param dataMatrix 
     * @param uiCache 
     *
     * @return 
     */
    protected int preUpdate(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor, DataMatrix dataMatrix,
        UICache uiCache) {

        return STATUS_CONTINUE;
    }

    /**
     * DOCUMENT ME!
     *
     * @param userInfo 
     * @param uiWebScreenSection 
     * @param request 
     * @param response 
     * @param delegator 
     * @param eventProcessor 
     * @param dataMatrix 
     * @param uiCache 
     *
     * @return 
     *
     * @throws GenericEntityException 
     */
    protected int update(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor, DataMatrix dataMatrix,
        UICache uiCache) throws GenericEntityException {

        int status = eventProcessor.processUpdate(userInfo, delegator,
                dataMatrix);

        return status;
    }

    /**
     * DOCUMENT ME!
     *
     * @param userInfo 
     * @param uiWebScreenSection 
     * @param request 
     * @param response 
     * @param delegator 
     * @param eventProcessor 
     * @param dataMatrix 
     * @param uiCache 
     *
     * @return 
     */
    protected int postUpdate(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor, DataMatrix dataMatrix,
        UICache uiCache) {

        return STATUS_CONTINUE;
    }

    //-------------------------------------------------------------------------
    // UPDATE_SELECT - Adds and/or deletes entities in a many-to-many relationship table the data base.
    //-------------------------------------------------------------------------
    protected int processUpdateSelect(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor) throws GenericEntityException {

        int status = STATUS_CONTINUE;

        ModelEntity primaryME = uiWebScreenSection.getUiScreenSectionEntity(0)
                                                  .getUiEntity().getModelEntity();

        // Get the items to add and remove from the request object.
        String unassignedItemString = request.getParameter("inpUnassigned");
        String assignedItemString = request.getParameter("inpAssigned");

        Debug.logVerbose("unassignedItemString: " + unassignedItemString, module);
        Debug.logVerbose("assignedItemString: " + assignedItemString, module);

        // Convert the strings to array lists of primary keys.
        String entityName = primaryME.getEntityName();
        ModelEntity modelEntity = delegator.getModelEntity(entityName);
        HashMap useQueryParameterValueMap = uiWebScreenSection.getUseQueryParameterValueMap();
        ArrayList removeKeyMapList = EventUtility.decodeSelectItem(useQueryParameterValueMap,
                unassignedItemString);
        ArrayList createKeyMapList = EventUtility.decodeSelectItem(useQueryParameterValueMap,
                assignedItemString);

        // Trigger the pre-update event.
        status = this.preUpdateSelect(userInfo, uiWebScreenSection, request,
                response, delegator, eventProcessor, primaryME,
                removeKeyMapList, createKeyMapList);

        if (status != STATUS_CONTINUE) {
            return status;
        }

        // Trigger the update event.
        status = this.updateSelect(userInfo, uiWebScreenSection, request,
                response, delegator, eventProcessor, primaryME,
                removeKeyMapList, createKeyMapList);

        if (status != STATUS_CONTINUE) {
            return status;
        }

        // Trigger the post-update event.
        status = this.postUpdateSelect(userInfo, uiWebScreenSection, request,
                response, delegator, eventProcessor, primaryME,
                removeKeyMapList, createKeyMapList);

        return status;
    }

    /**
     * DOCUMENT ME!
     *
     * @param userInfo 
     * @param uiWebScreenSection 
     * @param request 
     * @param response 
     * @param delegator 
     * @param eventProcessor 
     * @param primaryME 
     * @param removeKeyMapList 
     * @param createKeyMapList 
     *
     * @return 
     */
    protected int preUpdateSelect(UserInfo userInfo,
        UIWebScreenSection uiWebScreenSection, HttpServletRequest request,
        HttpServletResponse response, GenericDelegator delegator,
        GenericEventProcessor eventProcessor, ModelEntity primaryME,
        ArrayList removeKeyMapList, ArrayList createKeyMapList) {

        return STATUS_CONTINUE;