KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > jonathan > apis > presentation > MarshallerFactory


1 /***
2  * Jonathan: an Open Distributed Processing Environment
3  * Copyright (C) 1999 France Telecom R&D
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this library; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18  *
19  * Release: 2.0
20  *
21  * Contact: jonathan@objectweb.org
22  *
23  * Author: Bruno Dumant
24  *
25  */
26
27
28 package org.objectweb.jonathan.apis.presentation;
29
30 import org.objectweb.jonathan.apis.resources.Chunk;
31 import org.objectweb.jonathan.apis.resources.ChunkProvider;
32
33 /**
34  * a marshaller factory is a factory for marshallers and unmarshallers (...)
35  */
36 public interface MarshallerFactory {
37
38    /**
39     * Returns a new marshaller.
40     *
41     * @return a new marshaller.
42     */
43    Marshaller newMarshaller();
44
45    /**
46     * Returns a new unmarshaller, using the provided chunk provider as a data
47     * source.
48     *
49     * @param provider a chunk provider.
50     * @return a new unmarshaller.
51     */
52    UnMarshaller newUnMarshaller(ChunkProvider provider);
53
54
55    /**
56     * Returns a new unmarshaller, using the provided chunk(s) as a data source.
57     * <p>
58     * The <code>read</code> parameters is used to initialise the number of bytes
59     * read from the message.
60     *
61     * @param chunk a (chain of) chunk(s)
62     * @param read the number of bytes already read from the message.
63     * @return an unmarshaller.
64     */
65    UnMarshaller newUnMarshaller(Chunk chunk, int read);
66 }
67
68
Popular Tags