httpagent.java

来自「This is a resource based on j2me embedde」· Java 代码 · 共 95 行

/*
 *
 *
 * Copyright  1990-2008 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.kvem.netmon;

/**
 * This class is responsible on communication with the network monitor j2se 
 * side. Spesifically it communicate with <code>HttpMsgReceicver</code> which
 * receives the data and produce http messages. Having implement the 
 * <code>StreamAgent</code> interface enables it to work with the stream data
 * "stealer".
 *
 */
public class HttpAgent implements StreamAgent {
    private static HttpAgent inst = new HttpAgent();



    /**
     *  The agent is a singletone.
     *
     *@return    Description of the Returned Value
     */
    public static HttpAgent instance() {
        return inst;
    }

    /**
     * Called when a new stream is opend. The stream will produce messages
     * at the receiver side.
     *
     *@return    Message descriptor that will identify the
     *           stream in future method calls.
     */
    public native int newStream0(String url, int direction, long groupid);
    public int newStream(String url, int direction, long groupid){
        return newStream0(url,direction, groupid);
    }


    /**
     * Update the message identified by the message descriptor with
     * the byte data.
     *
     *@param  md  Message descriptor.
     *@param  b   data
     *
     */
    public native void write(int md, int b);


    /**
     * Update the message identified by the message descriptor with
     * the buffer data.
     *
     *@param  md    Message descriptor
     *@param  buff
     *@param  off
     *@param  len
     */
    public native void writeBuff(int md, byte[] buff, int off, int len);

    /**
     * The stream that is identified by the message descriptor md has
     * closed, no ferthure communication will be made with that descriptor.
     *
     *@param  md  Message descriptor.
     */
    public native void close(int md);

}