directconnectfailedexception.java

SRI international 发布的OAA框架软件

/* $Id: DirectConnectFailedException.java,v 1.1 2004/02/05 23:02:23 giuli Exp $
 * @(#)DirectConnectFailedException.java  02/2004
 *
 * The contents of this file are subject to the OAA Community Research
 * License Version 2.0 (the "License"); you may not use this file except
 * in compliance with the License. You may obtain a copy of the License
 * at http://www.ai.sri.com/~oaa/.  Software distributed under the License
 * is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * rights and limitations under the License.  Portions of the software are
 * Copyright (c) SRI International, 1999.  All rights reserved.
 * "OAA" is a registered trademark, and "Open Agent Architecture" is a
 * trademark, of SRI International, a California nonprofit public benefit
 * corporation.
*
*/

package com.sri.oaa2.agentlib;

import com.sri.oaa2.icl.IclList;

/**
 * DirectConnectFailedException is thrown when the agent is set to use
 * direct_connect but direct_connect was not actually used.
 * Even when direct_connect fails, valid answers are
 * probably produced via the "classic" OAA mechanism.
 *
 * @see Agent
 */
public class DirectConnectFailedException extends AgentException {
    private IclList answers;

    /**
     * Constructs a new exception with the specified detail message.
     * Used internally in the AgentLib Java library, this constructor
     * should not be needed by library users.
     */
    DirectConnectFailedException(String message, IclList answers) {
        super(message);
        this.answers = answers;
    }

    /**
     * Retrieves the answers which were received from the facilitator.
     * Even though direct_connect failed, valid answers were
     * probably produced via the "classic" OAA mechanism.
     *
     * @return the answers produced not using direct_connect
     * @see Agent
     */
    public IclList getAnswers() {
        return answers;
    }
}