communicationclient.java

来自「cqME :java framework for TCK test.」· Java 代码 · 共 82 行

/*
 * $Id$
 *
 * Copyright 1996-2007 Sun Microsystems, Inc. All Rights Reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License version
 * 2 only, as published by the Free Software Foundation.
 *
 * This program 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
 * General Public License version 2 for more details (a copy is
 * included at /legal/license.txt).
 *
 * You should have received a copy of the GNU General Public License
 * version 2 along with this work; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA
 *
 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
 * Clara, CA 95054 or visit www.sun.com if you need additional
 * information or have any questions.
 *
 */

package com.sun.tck.j2me.communication;

import java.io.IOException;

/**
 * This interface defines functionality required for communication
 * with JavaTest harness.
 *
 * <p>
 * An implementation of this class should provide a no-arguments
 * public constructor.
 */
public interface CommunicationClient {

    /**
     * Initializes the client.
     *
     * @param serverAddress The address to connect to.
     * @param connID The connection id.
     * @param args Any additional arguments.
     */
    public void init(String serverAddress, String connID, String[] args);

    /**
     * Specifies the maximum number of bytes this Client can receive.
     *
     * @return The maximum number of bytes to receive.
     */
    public int getSendLimitSize();

    /**
     * Specifies the maximum number of bytes this Client can send.
     *
     * @return The maximum number of bytes to send.
     */
    public int getRcvLimitSize();

    /**
     * Sends the specified bytes to the communication server and
     * retrieves the response.
     *
     * @param data
     *                The data to send.
     * @return The response from the server.
     * @throws IOException
     *                 In case of any errors during transmission.
     */
    public byte[] send(byte[] data) throws IOException;

    /**
     * Absolute maximum of bytes any Client can send/receive at once.
     */
    public final int MAX_LIMIT = Integer.MAX_VALUE;
}