/servers/diameter/core/jdiameter/impl/src/main/java/org/jdiameter/client/impl/app/gx/ClientGxSessionImpl.java

Large files files are truncated, but you can click here to view the full file

/*
 * JBoss, Home of Professional Open Source
 * Copyright 2010, Red Hat, Inc. and individual contributors
 * by the @authors tag. See the copyright.txt in the distribution for a
 * full listing of individual contributors.
 *
 * This is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * This software is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this software; if not, write to the Free
 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 */

package org.jdiameter.client.impl.app.gx;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashSet;
import java.util.Set;
import java.util.concurrent.locks.Lock;
import java.util.concurrent.locks.ReentrantLock;

import org.jdiameter.api.Answer;
import org.jdiameter.api.AvpDataException;
import org.jdiameter.api.EventListener;
import org.jdiameter.api.IllegalDiameterStateException;
import org.jdiameter.api.InternalException;
import org.jdiameter.api.Message;
import org.jdiameter.api.NetworkReqListener;
import org.jdiameter.api.OverloadException;
import org.jdiameter.api.Request;
import org.jdiameter.api.RouteException;
import org.jdiameter.api.app.AppAnswerEvent;
import org.jdiameter.api.app.AppEvent;
import org.jdiameter.api.app.AppSession;
import org.jdiameter.api.app.StateChangeListener;
import org.jdiameter.api.app.StateEvent;
import org.jdiameter.api.gx.events.GxReAuthAnswer;
import org.jdiameter.api.gx.events.GxReAuthRequest;
import org.jdiameter.api.gx.ClientGxSession;
import org.jdiameter.api.gx.ClientGxSessionListener;
import org.jdiameter.api.gx.events.GxCreditControlAnswer;
import org.jdiameter.api.gx.events.GxCreditControlRequest;
import org.jdiameter.client.api.IContainer;
import org.jdiameter.client.api.ISessionFactory;
import org.jdiameter.client.api.parser.IMessageParser;
import org.jdiameter.client.impl.app.gx.Event.Type;
import org.jdiameter.common.api.app.IAppSessionState;
import org.jdiameter.common.api.app.gx.ClientGxSessionState;
import org.jdiameter.common.api.app.gx.IClientGxSessionContext;
import org.jdiameter.common.api.app.gx.IGxMessageFactory;
import org.jdiameter.common.impl.app.AppAnswerEventImpl;
import org.jdiameter.common.impl.app.AppRequestEventImpl;
import org.jdiameter.common.impl.app.gx.GxReAuthAnswerImpl;
import org.jdiameter.common.impl.app.gx.AppGxSessionImpl;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * Client Credit-Control Application session implementation
 *
 * @author <a href="mailto:brainslog@gmail.com"> Alexandre Mendonca </a>
 * @author <a href="mailto:baranowb@gmail.com"> Bartosz Baranowski </a>
 * @author <a href="mailto:carl-magnus.bjorkell@emblacom.com"> Carl-Magnus Björkell </a>
 */
public class ClientGxSessionImpl extends AppGxSessionImpl implements ClientGxSession, NetworkReqListener, EventListener<Request, Answer> {

    private static final Logger logger = LoggerFactory.getLogger(ClientGxSessionImpl.class);
    protected IClientGxSessionData sessionData;
    // Session State Handling ---------------------------------------------------
    protected Lock sendAndStateLock = new ReentrantLock();
    // Factories and Listeners --------------------------------------------------
    protected IGxMessageFactory factory;
    protected ClientGxSessionListener listener;
    protected IClientGxSessionContext context;
    protected IMessageParser parser;
    // Tx Timer -----------------------------------------------------------------
    protected final static String TX_TIMER_NAME = "Gx_CLIENT_TX_TIMER";
    protected static final long TX_TIMER_DEFAULT_VALUE = 30 * 60 * 1000; // miliseconds

    protected long[] authAppIds = new long[]{4};
    // Requested Action + Credit-Control and Direct-Debiting Failure-Handling ---
    static final int NON_INITIALIZED = -300;
    protected static final int CCFH_TERMINATE = 0;
    protected static final int CCFH_CONTINUE = 1;
    protected static final int CCFH_RETRY_AND_TERMINATE = 2;
    private static final int DDFH_TERMINATE_OR_BUFFER = 0;
    private static final int DDFH_CONTINUE = 1;
    // CC-Request-Type Values ---------------------------------------------------
    private static final int DIRECT_DEBITING = 0;
    private static final int REFUND_ACCOUNT = 1;
    private static final int CHECK_BALANCE = 2;
    private static final int PRICE_ENQUIRY = 3;
    private static final int EVENT_REQUEST = 4;
    // Error Codes --------------------------------------------------------------
    private static final long END_USER_SERVICE_DENIED = 4010;
    private static final long CREDIT_CONTROL_NOT_APPLICABLE = 4011;
    private static final long USER_UNKNOWN = 5030;
    private static final long DIAMETER_UNABLE_TO_DELIVER = 3002L;
    private static final long DIAMETER_TOO_BUSY = 3004L;
    private static final long DIAMETER_LOOP_DETECTED = 3005L;
    protected static final Set<Long> temporaryErrorCodes;

    static {
        HashSet<Long> tmp = new HashSet<Long>();
        tmp.add(DIAMETER_UNABLE_TO_DELIVER);
        tmp.add(DIAMETER_TOO_BUSY);
        tmp.add(DIAMETER_LOOP_DETECTED);
        temporaryErrorCodes = Collections.unmodifiableSet(tmp);
    }
    // Session Based Queue
    protected ArrayList<Event> eventQueue = new ArrayList<Event>();


    public ClientGxSessionImpl(IClientGxSessionData sessionData, IGxMessageFactory fct, ISessionFactory sf, ClientGxSessionListener lst, IClientGxSessionContext ctx,
                               StateChangeListener<AppSession> stLst) {
        super(sf, sessionData);
        if (lst == null) {
            throw new IllegalArgumentException("Listener can not be null");
        }
        if (fct.getApplicationIds() == null) {
            throw new IllegalArgumentException("ApplicationId can not be less than zero");
        }

        this.context = (IClientGxSessionContext) ctx;

        this.authAppIds = fct.getApplicationIds();
        this.listener = lst;
        this.factory = fct;

        IContainer icontainer = sf.getContainer();
        this.parser = icontainer.getAssemblerFacility().getComponentInstance(IMessageParser.class);
        this.sessionData = sessionData;

        super.addStateChangeNotification(stLst);

    }

    protected int getLocalCCFH() {
        return this.sessionData.getGatheredCCFH() >= 0 ? this.sessionData.getGatheredCCFH() : context.getDefaultCCFHValue();
    }

    protected int getLocalDDFH() {
        return this.sessionData.getGatheredDDFH() >= 0 ? this.sessionData.getGatheredDDFH() : context.getDefaultDDFHValue();
    }

    public void sendCreditControlRequest(GxCreditControlRequest request) throws InternalException, IllegalDiameterStateException, RouteException, OverloadException {

        try {
            extractFHAVPs(request, null);
            this.handleEvent(new Event(true, request, null));
        } catch (AvpDataException e) {
            throw new InternalException(e);
        }
    }

    public void sendGxReAuthAnswer(GxReAuthAnswer answer) throws InternalException, IllegalDiameterStateException, RouteException, OverloadException {
        this.handleEvent(new Event(Event.Type.SEND_RAA, null, answer));
    }

    public boolean isStateless() {
        return false;
    }

    public boolean isEventBased() {
        return this.sessionData.isEventBased();
    }

    @SuppressWarnings("unchecked")
    public <E> E getState(Class<E> stateType) {
        return stateType == ClientGxSessionState.class ? (E) this.sessionData.getClientGxSessionState() : null;
    }

    public boolean handleEvent(StateEvent event) throws InternalException, OverloadException {
        return this.isEventBased() ? handleEventForEventBased(event) : handleEventForSessionBased(event);
    }

    protected boolean handleEventForEventBased(StateEvent event) throws InternalException, OverloadException {
        try {
            sendAndStateLock.lock();
            final ClientGxSessionState state = this.sessionData.getClientGxSessionState();
            Event localEvent = (Event) event;
            Event.Type eventType = (Type) localEvent.getType();
            switch (state) {

                case IDLE:
                    switch (eventType) {
                        case SEND_EVENT_REQUEST:
                            // Current State: IDLE
                            // Event: Client or device requests a one-time service
                            // Action: Send CC event request, start Tx
                            // New State: PENDING_E
                            startTx((GxCreditControlRequest) localEvent.getRequest());
                            setState(ClientGxSessionState.PENDING_EVENT);
                            try {
                                dispatchEvent(localEvent.getRequest());
                            } catch (Exception e) {
                                // This handles failure to send in PendingI state in FSM table
                                logger.debug("Failure handling send event request", e);
                                handleSendFailure(e, eventType, localEvent.getRequest().getMessage());
                            }
                            break;
                        default:
                            logger.warn("Wrong event type ({}) on state {}", eventType, state);
                            break;
                    }
                    break;

                case PENDING_EVENT:
                    switch (eventType) {
                        case RECEIVE_EVENT_ANSWER:
                            AppAnswerEvent answer = (AppAnswerEvent) localEvent.getAnswer();
                            try {
                                long resultCode = answer.getResultCodeAvp().getUnsigned32();
                                if (isSuccess(resultCode)) {
                                    // Current State: PENDING_E
                                    // Event: Successful CC event answer received
                                    // Action: Grant service to end user
                                    // New State: IDLE
                                    setState(ClientGxSessionState.IDLE, false);
                                }
                                if (isProvisional(resultCode) || isFailure(resultCode)) {
                                    handleFailureMessage((GxCreditControlAnswer) answer, (GxCreditControlRequest) localEvent.getRequest(), eventType);
                                }

                                deliverGxAnswer((GxCreditControlRequest) localEvent.getRequest(), (GxCreditControlAnswer) localEvent.getAnswer());
                            } catch (AvpDataException e) {
                                logger.debug("Failure handling received answer event", e);
                                setState(ClientGxSessionState.IDLE, false);
                            }
                            break;
                        case Tx_TIMER_FIRED:
                            handleTxExpires(localEvent.getRequest().getMessage());
                            break;
                        default:
                            logger.warn("Wrong event type ({}) on state {}", eventType, state);
                            break;
                    }
                    break;

                case PENDING_BUFFERED:
                    switch (eventType) {
                        case RECEIVE_EVENT_ANSWER:
                            // Current State: PENDING_B
                            // Event: Successful CC answer received
                            // Action: Delete request
                            // New State: IDLE
                            setState(ClientGxSessionState.IDLE, false);
                            this.sessionData.setBuffer(null);
                            deliverGxAnswer((GxCreditControlRequest) localEvent.getRequest(), (GxCreditControlAnswer) localEvent.getAnswer());
                            break;
                        default:
                            logger.warn("Wrong event type ({}) on state {}", eventType, state);
                            break;
                    }
                    break;

                default:
                    logger.warn("Wrong event type ({}) on state {}", eventType, state);
                    break;
            }

            dispatch();
            return true;
        } catch (Exception e) {
            throw new InternalException(e);
        } finally {
            sendAndStateLock.unlock();
        }
    }

    protected boolean handleEventForSessionBased(StateEvent event) throws InternalException, OverloadException {
        try {
            sendAndStateLock.lock();
            final ClientGxSessionState state = this.sessionData.getClientGxSessionState();
            final Event localEvent = (Event) event;
            final Event.Type eventType = (Type) localEvent.getType();
            switch (state) {

                case IDLE:
                    switch (eventType) {
                        case SEND_INITIAL_REQUEST:
                            // Current State: IDLE
                            // Event: Client or device requests access/service
                            // Action: Send CC initial request, start Tx
                            // New State: PENDING_I
                            startTx((GxCreditControlRequest) localEvent.getRequest());
                            setState(ClientGxSessionState.PENDING_INITIAL);
                            try {
                                dispatchEvent(localEvent.getRequest());
                            } catch (Exception e) {
                                // This handles failure to send in PendingI state in FSM table
                                handleSendFailure(e, eventType, localEvent.getRequest().getMessage());
                            }
                            break;
                        default:
                            logger.warn("Wrong event type ({}) on state {}", eventType, state);
                            break;
                    }
                    break;

                case PENDING_INITIAL:
                    AppAnswerEvent answer = (AppAnswerEvent) localEvent.getAnswer();
                    switch (eventType) {
                        case RECEIVED_INITIAL_ANSWER:
                            long resultCode = answer.getResultCodeAvp().getUnsigned32();
                            if (isSuccess(resultCode)) {
                                // Current State: PENDING_I
                                // Event: Successful CC initial answer received
                                // Action: Stop Tx
                                // New State: OPEN
                                stopTx();
                                setState(ClientGxSessionState.OPEN);
                            } else if (isProvisional(resultCode) || isFailure(resultCode)) {
                                handleFailureMessage((GxCreditControlAnswer) answer, (GxCreditControlRequest) localEvent.getRequest(), eventType);
                            }
                            deliverGxAnswer((GxCreditControlRequest) localEvent.getRequest(), (GxCreditControlAnswer) localEvent.getAnswer());
                            break;
                        case Tx_TIMER_FIRED:
                            handleTxExpires(localEvent.getRequest().getMessage());
                            break;
                        case SEND_UPDATE_REQUEST:
                        case SEND_TERMINATE_REQUEST:
                            // Current State: PENDING_I
                            // Event: User service terminated
                            // Action: Queue termination event
                            // New State: PENDING_I

                            // Current State: PENDING_I
                            // Event: Change in rating condition
                            // Action: Queue changed rating condition event
                            // New State: PENDING_I
                            eventQueue.add(localEvent);
                            break;
                        default:
                            logger.warn("Wrong event type ({}) on state {}", eventType, state);
                            break;
                    }
                    break;

                case OPEN:
                    switch (eventType) {
                        case SEND_UPDATE_REQUEST:
                            // Current State: OPEN
                            // Event: Granted unit elapses and no final unit indication received
                            // Action: Send CC update request, start Tx
                            // New State: PENDING_U

                            // Current State: OPEN
                            // Event: Change in rating condition in queue
                            // Action: Send CC update request, start Tx
                            // New State: PENDING_U

                            // Current State: OPEN
                            // Event: Change in rating condition or Validity-Time elapses
                            // Action: Send CC update request, start Tx
                            // New State: PENDING_U

                            // Current State: OPEN
                            // Event: RAR received
                            // Action: Send RAA followed by CC update request, start Tx
                            // New State: PENDING_U
                            startTx((GxCreditControlRequest) localEvent.getRequest());
                            setState(ClientGxSessionState.PENDING_UPDATE);
                            try {
                                dispatchEvent(localEvent.getRequest());
                            } catch (Exception e) {
                                // This handles failure to send in PendingI state in FSM table
                                handleSendFailure(e, eventType, localEvent.getRequest().getMessage());
                            }
                            break;
                        case SEND_TERMINATE_REQUEST:
                            // Current State: OPEN
                            // Event: Granted unit elapses and final unit action equal to TERMINATE received
                            // Action: Terminate end user?s service, send CC termination request
                            // New State: PENDING_T

                            // Current State: OPEN
                            // Event: Service terminated in queue
                            // Action: Send CC termination request
                            // New State: PENDING_T

                            // Current State: OPEN
                            // Event: User service terminated
                            // Action: Send CC termination request
                            // New State: PENDING_T
                            setState(ClientGxSessionState.PENDING_TERMINATION);
                            try {
                                dispatchEvent(localEvent.getRequest());
                            } catch (Exception e) {
                                handleSendFailure(e, eventType, localEvent.getRequest().getMessage());
                            }
                            break;
                        case RECEIVED_RAR:
                            deliverRAR((GxReAuthRequest) localEvent.getRequest());
                            break;
                        case SEND_RAA:
                            try {
                                dispatchEvent(localEvent.getAnswer());
                            } catch (Exception e) {
                                handleSendFailure(e, eventType, localEvent.getRequest().getMessage());
                            }
                            break;

                        default:
                            logger.warn("Wrong event type ({}) on state {}", eventType, state);
                            break;
                    }
                    break;

                case PENDING_UPDATE:
                    answer = (AppAnswerEvent) localEvent.getAnswer();
                    switch (eventType) {
                        case RECEIVED_UPDATE_ANSWER:
                            long resultCode = answer.getResultCodeAvp().getUnsigned32();
                            if (isSuccess(resultCode)) {
                                // Current State: PENDING_U
                                // Event: Successful CC update answer received
                                // Action: Stop Tx
                                // New State: OPEN
                                stopTx();
                                setState(ClientGxSessionState.OPEN);
                            } else if (isProvisional(resultCode) || isFailure(resultCode)) {
                                handleFailureMessage((GxCreditControlAnswer) answer, (GxCreditControlRequest) localEvent.getRequest(), eventType);
                            }
                            deliverGxAnswer((GxCreditControlRequest) localEvent.getRequest(), (GxCreditControlAnswer) localEvent.getAnswer());
                            break;
                        case Tx_TIMER_FIRED:
                            handleTxExpires(localEvent.getRequest().getMessage());
                            break;

                        case SEND_UPDATE_REQUEST:
                        case SEND_TERMINATE_REQUEST:
                            // Current State: PENDING_U
                            // Event: User service terminated
                            // Action: Queue termination event
                            // New State: PENDING_U

                            // Current State: PENDING_U
                            // Event: Change in rating condition
                            // Action: Queue changed rating condition event
                            // New State: PENDING_U
                            eventQueue.add(localEvent);
                            break;
                        case RECEIVED_RAR:
                            deliverRAR((GxReAuthRequest) localEvent.getRequest());
                            break;
                        case SEND_RAA:
                            // Current State: PENDING_U
                            // Event: RAR received
                            // Action: Send RAA
                            // New State: PENDING_U
                            try {
                                dispatchEvent(localEvent.getAnswer());
                            } catch (Exception e) {
                                handleSendFailure(e, eventType, localEvent.getRequest().getMessage());
                            }
                            break;
                    }

                    break;

                case PENDING_TERMINATION:
                    switch (eventType) {
                        case SEND_UPDATE_REQUEST:
                            try {
                                // Current State: PENDING_T
                                // Event: Change in rating condition
                                // Action: -
                                // New State: PENDING_T
                                dispatchEvent(localEvent.getRequest());
                                // No transition
                            } catch (Exception e) {
                                // This handles failure to send in PendingI state in FSM table
                                // handleSendFailure(e, eventType);
                            }
                            break;
                        case RECEIVED_TERMINATED_ANSWER:
                            // Current State: PENDING_T
                            // Event: Successful CC termination answer received
                            // Action: -
                            // New State: IDLE

                            // Current State: PENDING_T
                            // Event: Failure to send, temporary error, or failed answer
                            // Action: -
                            // New State: IDLE

                            //FIXME: Alex broke this, setting back "true" ?
                            //setState(ClientGxSessionState.IDLE, false);
                            deliverGxAnswer((GxCreditControlRequest) localEvent.getRequest(), (GxCreditControlAnswer) localEvent.getAnswer());
                            setState(ClientGxSessionState.IDLE, true);
                            break;
                        default:
                            logger.warn("Wrong event type ({}) on state {}", eventType, state);
                            break;
                    }
                    break;

                default:
                    // any other state is bad
                    setState(ClientGxSessionState.IDLE, true);
            }

            dispatch();
            return true;
        } catch (Exception e) {
            throw new InternalException(e);
        } finally {
            sendAndStateLock.unlock();
        }
    }

    public Answer processRequest(Request request) {
        RequestDelivery rd = new RequestDelivery();
        rd.session = this;
        rd.request = request;
        super.scheduler.execute(rd);
        return null;
    }

    public void receivedSuccessMessage(Request request, Answer answer) {
        AnswerDelivery ad = new AnswerDelivery();
        ad.session = this;
        ad.request = request;
        ad.answer = answer;
        super.scheduler.execute(ad);

    }

    public void timeoutExpired(Request request) {
        if (request.getCommandCode() == GxCreditControlAnswer.code) {
            try {
                sendAndStateLock.lock();
                handleSendFailure(null, null, request);
            }
            catch (Exception e) {
                logger.debug("Failure processing timeout message for request", e);
            }
            finally {
                sendAndStateLock.unlock();
            }
        }
    }

    protected void startTx(GxCreditControlRequest request) {
        long txTimerValue = context.getDefaultTxTimerValue();
        if (txTimerValue < 0) {
            txTimerValue = TX_TIMER_DEFAULT_VALUE;
        }
        stopTx();

        logger.debug("Scheduling TX Timer {}", txTimerValue);
        //this.txFuture = scheduler.schedule(new TxTimerTask(this, request), txTimerValue, TimeUnit.SECONDS);
        try {
           this.sessionData.setTxTimerRequest((Request) request.getMessage());
        } catch (Exception e) {
            throw new IllegalArgumentException("Failed to store request.", e);
        }
        this.sessionData.setTxTimerId(this.timerFacility.schedule(this.getSessionId(), TX_TIMER_NAME, TX_TIMER_DEFAULT_VALUE));
    }

    protected void stopTx() {
      Serializable txTimerId = this.sessionData.getTxTimerId();
      if (txTimerId != null) {
        this.timerFacility.cancel(txTimerId);
        this.sessionData.setTxTimerRequest(null);
        this.sessionData.setTxTimerId(null);
      }
    }

    /* (non-Javadoc)
     * @see org.jdiameter.common.impl.app.AppSessionImpl#onTimer(java.lang.String)
     */
    @Override
    public void onTimer(String timerName) {
        if (timerName.equals(TX_TIMER_NAME)) {
            new TxTimerTask(this, this.sessionData.getTxTimerRequest()).run();
        }
    }

    protected void setState(ClientGxSessionState newState) {
        setState(newState, true);
    }

    @SuppressWarnings("unchecked")
    protected void setState(ClientGxSessionState newState, boolean release) {
        try {
            IAppSessionState oldState = this.sessionData.getClientGxSessionState();
            this.sessionData.setClientGxSessionState(newState);
            for (StateChangeListener i : stateListeners) {
                i.stateChanged(this, (Enum) oldState, (Enum) newState);
            }

            if (newState == ClientGxSessionState.IDLE) {
                if (release) {
                    this.release();
                }
                stopTx();
            }
        } catch (Exception e) {
            if (logger.isDebugEnabled()) {
                logger.debug("Failure switching to state " + this.sessionData.getClientGxSessionState() + " (release=" + release + ")", e);
            }
        }
    }

    @Override
    public void release() {
      if (isValid()) {
        try {
          this.sendAndStateLock.lock();
          this.stopTx();
          super.release();
        }
        catch (Exception e) {
          logger.debug("Failed to release session", e);
        }
        finally {
          sendAndStateLock.unlock();
        }
      }
      else {
        logger.debug("Trying to release an already invalid session, with Session ID '{}'", getSessionId());
      }
    }

    protected void handleSendFailure(Exception e, Event.Type eventType, Message request) throws Exception {
        logger.debug("Failed to send message, type: {} message: {}, failure: {}", new Object[]{eventType, request, e != null ? e.getLocalizedMessage() : ""});
        try {
            // Event Based ----------------------------------------------------------
          final ClientGxSessionState state = this.sessionData.getClientGxSessionState();
          final int gatheredRequestedAction = sessionData.getGatheredRequestedAction();
            if (isEventBased()) {
                switch (state) {
                    case PENDING_EVENT:
                        if (gatheredRequestedAction == CHECK_BALANCE || gatheredRequestedAction == PRICE_ENQUIRY) {
                            // Current State: PENDING_E
                            // Event: Failure to send, temporary error, failed CC event answer received or Tx expired; requested action CHECK_BALANCE or PRICE_ENQUIRY
                            // Action: Indicate service error
                            // New State: IDLE
                            setState(ClientGxSessionState.IDLE);
                            context.indicateServiceError(this);
                        } else if (gatheredRequestedAction == DIRECT_DEBITING) {
                            switch (getLocalDDFH()) {
                                case DDFH_TERMINATE_OR_BUFFER:
                                    // Current State: PENDING_E
                                    // Event: Failure to send; request action DIRECT_DEBITING; DDFH equal to TERMINATE_OR_BUFFER
                                    // Action: Store request with T-flag
                                    // New State: IDLE
                                    request.setReTransmitted(true);
                                    this.sessionData.setBuffer((Request) request);

                                    setState(ClientGxSessionState.IDLE, false);
                                    break;
                                case DDFH_CONTINUE:
                                    // Current State: PENDING_E
                                    // Event: Failure to send, temporary error, failed CC event answer received or Tx expired; requested action DIRECT_DEBITING; DDFH equal to CONTINUE
                                    // Action: Grant service to end user
                                    // New State: IDLE
                                    context.grantAccessOnDeliverFailure(this, request);
                                    break;
                                default:
                                    logger.warn("Invalid Direct-Debiting-Failure-Handling AVP value {}", getLocalDDFH());
                            }
                        } else if (gatheredRequestedAction == REFUND_ACCOUNT) {
                            // Current State: PENDING_E
                            // Event: Failure to send or Tx expired; requested action REFUND_ACCOUNT
                            // Action: Store request with T-flag
                            // New State: IDLE
                            setState(ClientGxSessionState.IDLE, false);
                            request.setReTransmitted(true);
                            this.sessionData.setBuffer((Request) request);
                        } else {
                            logger.warn("Invalid Requested-Action AVP value {}", gatheredRequestedAction);
                        }
                        break;
                    case PENDING_BUFFERED:
                        // Current State: PENDING_B
                        // Event: Failure to send or temporary error
                        // Action: -
                        // New State: IDLE
                        setState(ClientGxSessionState.IDLE, false);
                        this.sessionData.setBuffer(null); // FIXME: Action does not mention, but ...
                        break;
                    default:
                        logger.warn("Wrong event type ({}) on state {}", eventType, state);
                        break;
                }
            } // Session Based --------------------------------------------------------
            else {
                switch (getLocalCCFH()) {
                    case CCFH_CONTINUE:
                        // Current State: PENDING_I
                        // Event: Failure to send, or temporary error and CCFH equal to CONTINUE
                        // Action: Grant service to end user
                        // New State: IDLE

                        // Current State: PENDING_U
                        // Event: Failure to send, or temporary error and CCFH equal to CONTINUE
                        // Action: Grant service to end user
                        // New State: IDLE
                        setState(ClientGxSessionState.IDLE, false);
                        this.context.grantAccessOnDeliverFailure(this, request);
                        break;

                    default:
                        // Current State: PENDING_I
                        // Event: Failure to send, or temporary error and CCFH equal to TERMINATE or to RETRY_AND_TERMINATE
                        // Action: Terminate end user?s service
                        // New State: IDLE

                        // Current State: PENDING_U
                        // Event: Failure to send, or temporary error and CCFH equal to TERMINATE or to RETRY_AND_TERMINATE
                        // Action: Terminate end user?s service
                        // New State: IDLE
                        this.context.denyAccessOnDeliverFailure(this, request);
                        setState(ClientGxSessionState.IDLE, true);
                        break;
                }
            }
        } finally {
            dispatch();
        }
    }

    protected void handleFailureMessage(final GxCreditControlAnswer event, final GxCreditControlRequest request, final Event.Type eventType) {
        try {
            // Event Based ----------------------------------------------------------
          final ClientGxSessionState state = this.sessionData.getClientGxSessionState();
          final int gatheredRequestedAction = sessionData.getGatheredRequestedAction();
          final Serializable txTimerId = sessionData.getTxTimerId();
            final long resultCode = event.getResultCodeAvp().getUnsigned32();
            if (isEventBased()) {
                switch (state) {
                    case PENDING_EVENT:
                        if (resultCode == END_USER_SERVICE_DENIED || resultCode == USER_UNKNOWN) {
                            if (sessionData.getTxTimerId() != null) {
                                // Current State: PENDING_E
                                // Event: CC event answer received with result code END_USER_SERVICE_DENIED or USER_UNKNOWN and Tx running
                                // Action: Terminate end user?s service
                                // New State: IDLE
                                context.denyAccessOnFailureMessage(this);
                                deliverGxAnswer(request, event);
                                setState(ClientGxSessionState.IDLE);
                            } else if (gatheredRequestedAction == DIRECT_DEBITING && txTimerId == null) {
                                // Current State: PENDING_E
                                // Event: Failed answer or answer received with result code END_USER_SERVICE DENIED or USER_UNKNOWN; requested action DIRECT_DEBITING; Tx expired
                                // Action: -
                                // New State: IDLE
                                setState(ClientGxSessionState.IDLE);
                            }
                        } else if (resultCode == CREDIT_CONTROL_NOT_APPLICABLE && gatheredRequestedAction == DIRECT_DEBITING) {
                            // Current State: PENDING_E
                            // Event: CC event answer received with result code CREDIT_CONTROL_NOT_APPLICABLE; requested action DIRECT_DEBITING
                            // Action: Grant service to end user
                            // New State: IDLE
                            context.grantAccessOnFailureMessage(this);
                            deliverGxAnswer(request, event);
                            setState(ClientGxSessionState.IDLE);
                        } else if (temporaryErrorCodes.contains(resultCode)) {
                            if (gatheredRequestedAction == CHECK_BALANCE || gatheredRequestedAction == PRICE_ENQUIRY) {
                                // Current State: PENDING_E
                                // Event: Failure to send, temporary error, failed CC event answer received or Tx expired; requested action CHECK_BALANCE or PRICE_ENQUIRY
                                // Action: Indicate service error
                                // New State: IDLE
                                context.indicateServiceError(this);
                                deliverGxAnswer(request, event);
                                setState(ClientGxSessionState.IDLE);
                            } else if (gatheredRequestedAction == DIRECT_DEBITING) {
                                if (getLocalDDFH() == DDFH_CONTINUE) {
                                    // Current State: PENDING_E
                                    // Event: Failure to send, temporary error, failed CC event answer received or Tx expired; requested action DIRECT_DEBITING; DDFH equal to CONTINUE
                                    // Action: Grant service to end user
                                    // New State: IDLE
                                    context.grantAccessOnFailureMessage(this);
                                    deliverGxAnswer(request, event);
                                    setState(ClientGxSessionState.IDLE);
                                } else if (getLocalDDFH() == DDFH_TERMINATE_OR_BUFFER && txTimerId != null) {
                                    // Current State: PENDING_E
                                    // Event: Failed CC event answer received or temporary error; requested action DIRECT_DEBITING; DDFH equal to TERMINATE_OR_BUFFER and Tx running
                                    // Action: Terminate end user?s service
                                    // New State: IDLE
                                    context.denyAccessOnFailureMessage(this);
                                    deliverGxAnswer(request, event);
                                    setState(ClientGxSessionState.IDLE);
                                }
                            } else if (gatheredRequestedAction == REFUND_ACCOUNT) {
                                // Current State: PENDING_E
                                // Event: Temporary error, and requested action REFUND_ACCOUNT
                                // Action: Store request
                                // New State: IDLE
                              this.sessionData.setBuffer((Request)  request.getMessage());
                                setState(ClientGxSessionState.IDLE, false);
                            } else {
                                logger.warn("Invalid combination for Ro Client FSM: State {}, Result-Code {}, Requested-Action {}, DDFH {}, Tx {}", new Object[]{state, resultCode, gatheredRequestedAction, getLocalDDFH(), txTimerId});
                            }
                        } else { // Failure
                            if (gatheredRequestedAction == CHECK_BALANCE || gatheredRequestedAction == PRICE_ENQUIRY) {
                                // Current State: PENDING_E
                                // Event: Failure to send, temporary error, failed CC event answer received or Tx expired; requested action CHECK_BALANCE or PRICE_ENQUIRY
                                // Action: Indicate service error
                                // New State: IDLE
                                context.indicateServiceError(this);
                                deliverGxAnswer(request, event);
                                setState(ClientGxSessionState.IDLE);
                            } else if (gatheredRequestedAction == DIRECT_DEBITING) {
                                if (getLocalDDFH() == DDFH_CONTINUE) {
                                    // Current State: PENDING_E
                                    // Event: Failure to send, temporary error, failed CC event answer received or Tx expired; requested action DIRECT_DEBITING; DDFH equal to CONTINUE
                                    // Action: Grant service to end user
                                    // New State: IDLE
                                    context.grantAccessOnFailureMessage(this);
                                    deliverGxAnswer(request, event);
                                    setState(ClientGxSessionState.IDLE);
                                } else if (getLocalDDFH() == DDFH_TERMINATE_OR_BUFFER && txTimerId != null) {
                                    // Current State: PENDING_E
                                    // Event: Failed CC event answer received or temporary error; requested action DIRECT_DEBITING; DDFH equal to TERMINATE_OR_BUFFER and Tx running
                                    // Action: Terminate end user?s service
                                    // New State: IDLE
                                    context.denyAccessOnFailureMessage(this);
                                    deliverGxAnswer(request, event);
                                    setState(ClientGxSessionState.IDLE);
                                }
                            } else if (gatheredRequestedAction == REFUND_ACCOUNT) {
                                // Current State: PENDING_E
                                // Event: Failed CC event answer received; requested action REFUND_ACCOUNT
                                // Action: Indicate service error and delete request
                                // New State: IDLE
                                this.sessionData.setBuffer(null);
                                context.indicateServiceError(this);
                                deliverGxAnswer(request, event);
                                setState(ClientGxSessionState.IDLE);
                            } else {
                                logger.warn("Invalid combination for Ro Client FSM: State {}, Result-Code {}, Requested-Action {}, DDFH {}, Tx {}", new Object[]{state, resultCode, gatheredRequestedAction, getLocalDDFH(), txTimerId});
                            }
                        }
                        break;

                    case PENDING_BUFFERED:
                        // Current State: PENDING_B
                        // Event: Failed CC answer received
                        // Action: Delete request
                        // New State: IDLE
                      this.sessionData.setBuffer(null);
                        setState(ClientGxSessionState.IDLE, false);
                        break;
                    default:
                        logger.warn("Wrong event type ({}) on state {}", eventType, state);
                }
            } // Session Based --------------------------------------------------------
            else {
                switch (state) {
                    case PENDING_INITIAL:
                        if (resultCode == CREDIT_CONTROL_NOT_APPLICABLE) {
                            // Current State: PENDING_I
                            // Event: CC initial answer received with result code equal to CREDIT_CONTROL_NOT_APPLICABLE
                            // Action: Grant service to end user
                            // New State: IDLE
                            context.grantAccessOnFailureMessage(this);
                            setState(ClientGxSessionState.IDLE, false);
                        } else if ((resultCode == END_USER_SERVICE_DENIED) || (resultCode == USER_UNKNOWN)) {
                            // Current State: PENDING_I
                            // Event: CC initial answer received with result code END_USER_SERVICE_DENIED or USER_UNKNOWN
                            // Action: Terminate end user?s service
                            // New State: IDLE
                            context.denyAccessOnFailureMessage(this);
                            setState(ClientGxSessionState.IDLE, false);
                        } else {
                            // Temporary errors and others
                            switch (getLocalCCFH()) {
                                case CCFH_CONTINUE:
                                    // Current State: PENDING_I
                                    // Event: Failed CC initial answer received and CCFH equal to CONTINUE
                                    // Action: Grant service to end user
                                    // New State: IDLE
                                    context.grantAccessOnFailureMessage(this);
                                    setState(ClientGxSessionState.IDLE, false);
                                    break;
                                case CCFH_TERMINATE:
                                case CCFH_RETRY_AND_TERMINATE:
                                    // Current State: PENDING_I
                                    // Event: Failed CC initial answer received and CCFH equal to TERMINATE or to RETRY_AND_TERMINATE
                                    // Action: Terminate end user?s service
                                    // New State: IDLE
                                    context.denyAccessOnFailureMessage(this);
                                    setState(ClientGxSessionState.IDLE, false);
                                    break;
                                default:
                                    logger.warn("Invalid value for CCFH: {}", getLocalCCFH());
                                    break;
                            }
                        }
                        break;

                    case PENDING_UPDATE:
                        if (resultCode == CREDIT_CONTROL_NOT_APPLICABLE) {
                            // Current State: PENDING_U
                            // Event: CC update answer received with result code equal to CREDIT_CONTROL_NOT_APPLICABLE
                            // Action: Grant service to end user
                            // New State: IDLE
                            context.grantAccessOnFailureMessage(this);
                            setState(ClientGxSessionState.IDLE, false);
                        } else if (resultCode == END_USER_SERVICE_DENIED) {
                            // Current State: PENDING_U
                            // Event: CC update answer received with result code END_USER_SERVICE_DENIED
                            // Action: Terminate end user?s service
                            // New State: IDLE
                            context.denyAccessOnFailureMessage(this);
                            setState(ClientGxSessionState.IDLE, false);
                        } else {
                            // Temporary errors and others
                            switch (getLocalCCFH()) {
                                case CCFH_CONTINUE:
                                    // Current State: PENDING_U
                                    // Event: Failed CC update answer received and CCFH equal to CONTINUE
                                    // Action: Grant service to end user
                                    // New State: IDLE
                                    context.grantAccessOnFailureMessage(this);
                                    setState(ClientGxSessionState.IDLE, false);
                                    break;
                                case CCFH_TERMINATE:
                                case CCFH_RETRY_AND_TERMINATE:
                                    // Current State: PENDING_U
                                    // Event: Failed CC update answer received and CCFH equal to CONTINUE or to RETRY_AND_CONTINUE
                                    // Action: Terminate end user?s service
                                    // New State: IDLE
                                    context.denyAccessOnFailureMessage(this);
                                    setState(ClientGxSessionState.IDLE, false);
                                    break;
                                default:
                                    logger.warn("Invalid value for CCFH: " + getLocalCCFH());
                                    break;
    …

Large files files are truncated, but you can click here to view the full file