- java.lang.Object
-
- javax.print.attribute.EnumSyntax
-
- All Implemented Interfaces:
- Serializable, Cloneable
- Direct Known Subclasses:
- Chromaticity, ColorSupported, Compression, DialogTypeSelection, Fidelity, Finishings, JobSheets, JobState, JobStateReason, Media, MultipleDocumentHandling, OrientationRequested, PDLOverrideSupported, PresentationDirection, PrinterIsAcceptingJobs, PrinterState, PrinterStateReason, PrintQuality, ReferenceUriSchemesSupported, Severity, SheetCollate, Sides
public abstract class EnumSyntax extends Object implements Serializable, Cloneable
Class EnumSyntax is an abstract base class providing the common implementation of all "type safe enumeration" objects. An enumeration class (which extends class EnumSyntax) provides a group of enumeration values (objects) that are singleton instances of the enumeration class; for example:public class Bach extends EnumSyntax { public static final Bach JOHANN_SEBASTIAN = new Bach(0); public static final Bach WILHELM_FRIEDEMANN = new Bach(1); public static final Bach CARL_PHILIP_EMMANUEL = new Bach(2); public static final Bach JOHANN_CHRISTIAN = new Bach(3); public static final Bach P_D_Q = new Bach(4); private static final String[] stringTable = { "Johann Sebastian Bach", "Wilhelm Friedemann Bach", "Carl Philip Emmanuel Bach", "Johann Christian Bach", "P.D.Q. Bach" }; protected String[] getStringTable() { return stringTable; } private static final Bach[] enumValueTable = { JOHANN_SEBASTIAN, WILHELM_FRIEDEMANN, CARL_PHILIP_EMMANUEL, JOHANN_CHRISTIAN, P_D_Q }; protected EnumSyntax[] getEnumValueTable() { return enumValueTable; } }
You can then write code that uses the==
and!=
operators to test enumeration values; for example:Bach theComposer; . . . if (theComposer == Bach.JOHANN_SEBASTIAN) { System.out.println ("The greatest composer of all time!"); }
Theequals()
method for an enumeration class just does a test for identical objects (==
).You can convert an enumeration value to a string by calling
. The string is obtained from a table supplied by the enumeration class.toString()
Under the hood, an enumeration value is just an integer, a different integer for each enumeration value within an enumeration class. You can get an enumeration value's integer value by calling
. An enumeration value's integer value is established when it is constructed (seegetValue()
). Since the constructor is protected, the only possible enumeration values are the singleton objects declared in the enumeration class; additional enumeration values cannot be created at run time.EnumSyntax(int)
You can define a subclass of an enumeration class that extends it with additional enumeration values. The subclass's enumeration values' integer values need not be distinct from the superclass's enumeration values' integer values; the
==
,!=
,equals()
, andtoString()
methods will still work properly even if the subclass uses some of the same integer values as the superclass. However, the application in which the enumeration class and subclass are used may need to have distinct integer values in the superclass and subclass.- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Modifier Constructor and Description protected
EnumSyntax(int value)
Construct a new enumeration value with the given integer value.
-
Method Summary
Methods Modifier and Type Method and Description Object
clone()
Returns a clone of this enumeration value, which to preserve the semantics of enumeration values is the same object as this enumeration value.protected EnumSyntax[]
getEnumValueTable()
Returns the enumeration value table for this enumeration value's enumeration class.protected int
getOffset()
Returns the lowest integer value used by this enumeration value's enumeration class.protected String[]
getStringTable()
Returns the string table for this enumeration value's enumeration class.int
getValue()
Returns this enumeration value's integer value.int
hashCode()
Returns a hash code value for this enumeration value.protected Object
readResolve()
During object input, convert this deserialized enumeration instance to the proper enumeration value defined in the enumeration attribute class.String
toString()
Returns a string value corresponding to this enumeration value.
-
-
-
Constructor Detail
-
EnumSyntax
protected EnumSyntax(int value)
Construct a new enumeration value with the given integer value.- Parameters:
value
- Integer value.
-
-
Method Detail
-
getValue
public int getValue()
Returns this enumeration value's integer value.- Returns:
- the value
-
clone
public Object clone()
Returns a clone of this enumeration value, which to preserve the semantics of enumeration values is the same object as this enumeration value.
-
hashCode
public int hashCode()
Returns a hash code value for this enumeration value. The hash code is just this enumeration value's integer value.- Overrides:
hashCode
in classObject
- Returns:
- a hash code value for this object.
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
toString
public String toString()
Returns a string value corresponding to this enumeration value.
-
readResolve
protected Object readResolve() throws ObjectStreamException
During object input, convert this deserialized enumeration instance to the proper enumeration value defined in the enumeration attribute class.- Returns:
- The enumeration singleton value stored at index
i-L in the enumeration value table returned by
, where i is this enumeration value's integer value and L is the value returned bygetEnumValueTable()
.getOffset()
- Throws:
ObjectStreamException
- if the stream can't be deserialisedInvalidObjectException
- Thrown if the enumeration value table is null, this enumeration value's integer value does not correspond to an element in the enumeration value table, or the corresponding element in the enumeration value table is null. (Note:InvalidObjectException
is a subclass ofObjectStreamException
, whichreadResolve()
is declared to throw.)
-
getStringTable
protected String[] getStringTable()
Returns the string table for this enumeration value's enumeration class. The enumeration class's integer values are assumed to lie in the range L..L+N-1, where L is the value returned by
and N is the length of the string table. The element in the string table at index i-L is the value returned bygetOffset()
for the enumeration value whose integer value is i. If an integer within the above range is not used by any enumeration value, leave the corresponding table element null.toString()
The default implementation returns null. If the enumeration class (a subclass of class EnumSyntax) does not override this method to return a non-null string table, and the subclass does not override the
method, the base classtoString()
method will return just a string representation of this enumeration value's integer value.toString()
- Returns:
- the string table
-
getEnumValueTable
protected EnumSyntax[] getEnumValueTable()
Returns the enumeration value table for this enumeration value's enumeration class. The enumeration class's integer values are assumed to lie in the range L..L+N-1, where L is the value returned by
and N is the length of the enumeration value table. The element in the enumeration value table at index i-L is the enumeration value object whose integer value is i; thegetOffset()
method needs this to preserve singleton semantics during deserialization of an enumeration instance. If an integer within the above range is not used by any enumeration value, leave the corresponding table element null.readResolve()
The default implementation returns null. If the enumeration class (a subclass of class EnumSyntax) does not override this method to return a non-null enumeration value table, and the subclass does not override the
method, the base classreadResolve()
method will throw an exception whenever an enumeration instance is deserialized from an object input stream.readResolve()
- Returns:
- the value table
-
getOffset
protected int getOffset()
Returns the lowest integer value used by this enumeration value's enumeration class.The default implementation returns 0. If the enumeration class (a subclass of class EnumSyntax) uses integer values starting at other than 0, override this method in the subclass.
- Returns:
- the offset of the lowest enumeration value.
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/print/attribute/enumsyntax.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.