01: // LabelBureauInterface.java
02: // $Id: LabelBureauInterface.java,v 1.4 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: /**
09: * Interface for the label bureau.
10: * This interface that the PICS protocol handler relies on to get the labels
11: * for any URL.
12: */
13:
14: public interface LabelBureauInterface {
15: /**
16: * Tag for the minimal label format.
17: */
18: public static final int FMT_MINIMAL = 1;
19: /**
20: * Tag for the short label format.
21: */
22: public static final int FMT_SHORT = 2;
23: /**
24: * Tag for the full label format.
25: */
26: public static final int FMT_FULL = 3;
27: /**
28: * Tag for the signed label format.
29: */
30: public static final int FMT_SIGNED = 4;
31:
32: /**
33: * Get this bureau identifier.
34: * A bureau should have a uniq String identifier, which is used by the PICS
35: * filter to create it (through the LabelBureauFactory), dump it and
36: * restore it.
37: */
38:
39: public String getIdentifier();
40:
41: /**
42: * Get a label service handler, given its identifier.
43: * A service identifier is expected to be its URL, as defined in the PICS
44: * specification.
45: * @param identifier The service URL identifier.
46: * @return An object conforming to the LabelServiceInterface, or
47: * <strong>null</strong> if none was found.
48: */
49:
50: public LabelServiceInterface getLabelService(String identifier);
51:
52: }
|