/*
 *  Licensed to the Apache Software Foundation (ASF) under one or more
*  contributor license agreements.  See the NOTICE file distributed with
*  this work for additional information regarding copyright ownership.
*  The ASF licenses this file to You under the Apache 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.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

package org.apache.yoko.orb.OCI;

//
// IDL:orb.yoko.apache.org/OCI/TransportInfo:1.0
//
/**
 *
 * Information on an OCI Transport object. Objects of this type must
 * be narrowed to a Transport information object for a concrete
 * protocol implementation, for example to
 * <code>OCI::IIOP::TransportInfo</code> in case the plug-in
 * implements IIOP.
 *
 * @see Transport
 *
 **/

public interface TransportInfoOperations
{
    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/id:1.0
    //
    /** The plugin id. */

    String
    id();

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/tag:1.0
    //
    /** The profile id tag. */

    int
    tag();

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/connector_info:1.0
    //

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/acceptor_info:1.0
    //

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/origin:1.0
    //
    /**
     *
     * The origin indicates whether the transport was originally
     * created by a server side accept or a client side connect.  This
     * is information is required for connection lifecycle management
     * in bidirectional communications.  This information cannot be
     * inferred by the connector_info and acceptor_info attributes as
     * they may both be set in a bidirectional case.
     *
     * @return <code>CLIENT_SIDE</code> if transport was initially
     * created as a client side connection.  <code>SERVER_SIDE</code>
     * if transport was initially created to handle incoming requests.
     *
     **/

    short
    origin();

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/describe:1.0
    //
    /**
     *
     * Returns a human readable description of the transport.
     *
     * @return The description.
     *
     **/

    String
    describe();

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/add_close_cb:1.0
    //

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/remove_close_cb:1.0
    //

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/get_service_contexts:1.0
    //
    /**
     *
     * Returns a sequence of service contexts for this transport based
     * on the policies.  Certain policies result in service contexts
     * being applied to requests.
     *
     * @param policies The CORBA Policy list.
     *
     * @return The service contexts for the given polices.
     *
     **/

    org.omg.IOP.ServiceContext[]
    get_service_contexts(org.omg.CORBA.Policy[] policies);

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/handle_service_contexts:1.0
    //
    /**
     *
     * Handles service contexts that might be received during a
     * request.  This allows transports to change their internal state
     * or behavior during their runtime.
     *
     * @param contexts The service context list
     *
     **/

    void
    handle_service_contexts(org.omg.IOP.ServiceContext[] contexts);

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/received_bidir_SCL:1.0
    //
    /**
     *
     * Queries whether this' transport has received a BiDir SCL in a
     * request.
     *
     **/

    boolean
    received_bidir_SCL();

    //
    // IDL:orb.yoko.apache.org/OCI/TransportInfo/endpoint_alias_match:1.0
    //
    /**
     *
     * Uses the BiDir SCL information in this TransportInfo to check
     * whether we can be used as a BiDir connection alias instead of
     * creating a new connection with the information specified in the
     * ConnectorInfo paramater
     *
     **/

    boolean
    endpoint_alias_match(ConnectorInfo connInfo);
}