01: // LabelServiceInterface.java
02: // $Id: LabelServiceInterface.java,v 1.3 2000/08/16 21:37:43 ylafon Exp $
03: // (c) COPYRIGHT MIT and INRIA, 1996.
04: // Please first read the full copyright statement in file COPYRIGHT.html
05:
06: package org.w3c.jigsaw.pics;
07:
08: import java.net.URL;
09:
10: public interface LabelServiceInterface {
11:
12: /**
13: * Get the specific labels for a given URL.
14: * @param url The URL whose label is to be fetched.
15: * @return An object conorminig to the LabelInterface, or
16: * <strong>null</strong> if none was found.
17: */
18:
19: public LabelInterface getSpecificLabel(URL u);
20:
21: /**
22: * Get the most specific generic label for the given URL.
23: * @param url The URL whose label is to be retreived.
24: * @return An object conforming to the LabelInterface, or
25: * <strong>null</strong> if none was found.
26: */
27:
28: public LabelInterface getGenericLabel(URL u);
29:
30: /**
31: * Get the tree labels for the given URL.
32: * @param url The URL whose tree labels are to be retreieved.
33: * @return An array of objects conforming to the LabelInterface, or
34: * <strong>null</strong> if none was found.
35: */
36:
37: public LabelInterface[] getTreeLabels(URL u);
38:
39: /**
40: * Get the generic tree labels for the given URL.
41: * @param url The URL whose labels is to be retreieved.
42: * @return An array of object conforming to the LabelInterface, or
43: * <strong>null<?strong> if none was found.
44: */
45:
46: public LabelInterface[] getGenericTreeLabels(URL u);
47:
48: /**
49: * Dump this service description into the provided buffer.
50: * This method is called by the protocol handler, whenever it needs to send
51: * back the service description.
52: * @param buffer The buffer in whichi to dump the service description.
53: * @param format The format in which this service is to be dumped (which
54: * can be any of ... FIXME)
55: */
56:
57: public void dump(StringBuffer buffer, int format);
58:
59: }
|