
2005-02-17 Michael Koch <konqueror@gmx.de> * gnu/java/awt/peer/gtk/GThreadNativeMethodRunner.java, gnu/java/awt/peer/gtk/GdkFontPeer.java, gnu/java/awt/peer/gtk/GdkGlyphVector.java, gnu/java/awt/peer/gtk/GdkGraphics.java, gnu/java/awt/peer/gtk/GdkGraphics2D.java, gnu/java/awt/peer/gtk/GdkGraphicsConfiguration.java, gnu/java/awt/peer/gtk/GdkGraphicsEnvironment.java, gnu/java/awt/peer/gtk/GdkPixbufDecoder.java, gnu/java/awt/peer/gtk/GdkRobotPeer.java, gnu/java/awt/peer/gtk/GdkScreenGraphicsDevice.java, gnu/java/awt/peer/gtk/GdkTextLayout.java, gnu/java/awt/peer/gtk/GtkCheckboxMenuItemPeer.java, gnu/java/awt/peer/gtk/GtkChoicePeer.java, gnu/java/awt/peer/gtk/GtkClipboard.java, gnu/java/awt/peer/gtk/GtkComponentPeer.java, gnu/java/awt/peer/gtk/GtkFileDialogPeer.java, gnu/java/awt/peer/gtk/GtkFontPeer.java, gnu/java/awt/peer/gtk/GtkLabelPeer.java, gnu/java/awt/peer/gtk/GtkMenuBarPeer.java, gnu/java/awt/peer/gtk/GtkMenuItemPeer.java, gnu/java/awt/peer/gtk/GtkMenuPeer.java, gnu/java/awt/peer/gtk/GtkScrollPanePeer.java, gnu/java/awt/peer/gtk/GtkScrollbarPeer.java, gnu/java/awt/peer/gtk/GtkToolkit.java, gnu/java/awt/peer/gtk/GtkWindowPeer.java, java/applet/Applet.java, java/awt/AWTError.java, java/awt/AWTEvent.java, java/awt/AWTEventMulticaster.java, java/awt/AWTException.java, java/awt/AWTKeyStroke.java, java/awt/AWTPermission.java, java/awt/ActiveEvent.java, java/awt/Adjustable.java, java/awt/AlphaComposite.java, java/awt/AttributeValue.java, java/awt/BorderLayout.java, java/awt/BufferCapabilities.java, java/awt/Button.java, java/awt/Canvas.java, java/awt/CheckboxGroup.java, java/awt/CheckboxMenuItem.java, java/awt/Color.java, java/awt/ColorPaintContext.java, java/awt/Component.java, java/awt/ComponentOrientation.java, java/awt/Composite.java, java/awt/CompositeContext.java, java/awt/Container.java, java/awt/ContainerOrderFocusTraversalPolicy.java, java/awt/DefaultFocusTraversalPolicy.java, java/awt/Dialog.java, java/awt/Dimension.java, java/awt/DisplayMode.java, java/awt/EventQueue.java, java/awt/FileDialog.java, java/awt/FontFormatException.java, java/awt/Graphics.java, java/awt/Graphics2D.java, java/awt/GraphicsConfigTemplate.java, java/awt/GraphicsConfiguration.java, java/awt/GraphicsDevice.java, java/awt/GridBagLayout.java, java/awt/GridBagLayoutInfo.java, java/awt/GridLayout.java, java/awt/HeadlessException.java, java/awt/IllegalComponentStateException.java, java/awt/Image.java, java/awt/Insets.java, java/awt/ItemSelectable.java, java/awt/JobAttributes.java, java/awt/KeyEventDispatcher.java, java/awt/KeyEventPostProcessor.java, java/awt/KeyboardFocusManager.java, java/awt/Label.java, java/awt/LayoutManager.java, java/awt/MenuBar.java, java/awt/MenuComponent.java, java/awt/MenuContainer.java, java/awt/PageAttributes.java, java/awt/Paint.java, java/awt/PaintContext.java, java/awt/Panel.java, java/awt/Point.java, java/awt/Polygon.java, java/awt/PrintGraphics.java, java/awt/PrintJob.java, java/awt/Rectangle.java, java/awt/RenderingHints.java, java/awt/Shape.java, java/awt/Stroke.java, java/awt/SystemColor.java, java/awt/Toolkit.java, java/awt/Transparency.java, java/awt/Window.java, java/awt/color/CMMException.java, java/awt/color/ColorSpace.java, java/awt/color/ICC_ColorSpace.java, java/awt/color/ICC_Profile.java, java/awt/color/ProfileDataException.java, java/awt/datatransfer/FlavorTable.java, java/awt/datatransfer/MimeTypeParseException.java, java/awt/datatransfer/Transferable.java, java/awt/datatransfer/UnsupportedFlavorException.java, java/awt/dnd/Autoscroll.java, java/awt/dnd/DnDConstants.java, java/awt/dnd/DragGestureListener.java, java/awt/dnd/DragSourceAdapter.java, java/awt/dnd/DragSourceDropEvent.java, java/awt/dnd/DragSourceListener.java, java/awt/dnd/DragSourceMotionListener.java, java/awt/dnd/DropTargetAdapter.java, java/awt/dnd/DropTargetContext.java, java/awt/dnd/DropTargetListener.java, java/awt/dnd/InvalidDnDOperationException.java, java/awt/dnd/MouseDragGestureRecognizer.java, java/awt/dnd/peer/DropTargetContextPeer.java, java/awt/event/AWTEventListener.java, java/awt/event/AWTEventListenerProxy.java, java/awt/event/ActionEvent.java, java/awt/event/AdjustmentEvent.java, java/awt/event/AdjustmentListener.java, java/awt/event/ComponentAdapter.java, java/awt/event/ComponentEvent.java, java/awt/event/ComponentListener.java, java/awt/event/ContainerAdapter.java, java/awt/event/ContainerEvent.java, java/awt/event/ContainerListener.java, java/awt/event/FocusAdapter.java, java/awt/event/FocusEvent.java, java/awt/event/FocusListener.java, java/awt/event/InputEvent.java, java/awt/event/InputMethodEvent.java, java/awt/event/InputMethodListener.java, java/awt/event/InvocationEvent.java, java/awt/event/ItemEvent.java, java/awt/event/ItemListener.java, java/awt/event/KeyAdapter.java, java/awt/event/KeyEvent.java, java/awt/event/KeyListener.java, java/awt/event/MouseAdapter.java, java/awt/event/MouseEvent.java, java/awt/event/MouseListener.java, java/awt/event/MouseMotionAdapter.java, java/awt/event/MouseMotionListener.java, java/awt/event/MouseWheelEvent.java, java/awt/event/MouseWheelListener.java, java/awt/event/PaintEvent.java, java/awt/event/TextEvent.java, java/awt/event/TextListener.java, java/awt/event/WindowAdapter.java, java/awt/event/WindowEvent.java, java/awt/event/WindowFocusListener.java, java/awt/event/WindowListener.java, java/awt/event/WindowStateListener.java, java/awt/font/TextHitInfo.java, java/awt/geom/CubicCurve2D.java, java/awt/geom/Dimension2D.java, java/awt/geom/Ellipse2D.java, java/awt/geom/IllegalPathStateException.java, java/awt/geom/Line2D.java, java/awt/geom/NoninvertibleTransformException.java, java/awt/geom/PathIterator.java, java/awt/geom/Point2D.java, java/awt/geom/QuadCurve2D.java, java/awt/geom/RectangularShape.java, java/awt/geom/RoundRectangle2D.java, java/awt/im/InputContext.java, java/awt/im/InputMethodHighlight.java, java/awt/im/InputMethodRequests.java, java/awt/im/InputSubset.java, java/awt/im/spi/InputMethod.java, java/awt/im/spi/InputMethodDescriptor.java, java/awt/image/BandCombineOp.java, java/awt/image/BandedSampleModel.java, java/awt/image/ByteLookupTable.java, java/awt/image/ComponentSampleModel.java, java/awt/image/DataBuffer.java, java/awt/image/DataBufferByte.java, java/awt/image/DataBufferDouble.java, java/awt/image/DataBufferFloat.java, java/awt/image/DataBufferInt.java, java/awt/image/DataBufferShort.java, java/awt/image/DataBufferUShort.java, java/awt/image/ImagingOpException.java, java/awt/image/Kernel.java, java/awt/image/LookupTable.java, java/awt/image/MultiPixelPackedSampleModel.java, java/awt/image/PackedColorModel.java, java/awt/image/PixelInterleavedSampleModel.java, java/awt/image/RGBImageFilter.java, java/awt/image/Raster.java, java/awt/image/RasterFormatException.java, java/awt/image/SampleModel.java, java/awt/image/ShortLookupTable.java, java/awt/image/SinglePixelPackedSampleModel.java, java/awt/image/WritableRaster.java, java/awt/print/PrinterAbortException.java, java/awt/print/PrinterException.java, java/awt/print/PrinterIOException.java, java/beans/AppletInitializer.java, java/beans/ExceptionListener.java, java/beans/PropertyChangeEvent.java, java/beans/PropertyChangeListenerProxy.java, java/beans/PropertyChangeSupport.java, java/beans/PropertyDescriptor.java, java/beans/VetoableChangeListenerProxy.java, java/beans/VetoableChangeSupport.java, java/io/BufferedReader.java, java/io/ByteArrayInputStream.java, java/io/ByteArrayOutputStream.java, java/io/CharArrayReader.java, java/io/CharArrayWriter.java, java/io/CharConversionException.java, java/io/DataInput.java, java/io/DataInputStream.java, java/io/DataOutput.java, java/io/DataOutputStream.java, java/io/EOFException.java, java/io/FileInputStream.java, java/io/FileNotFoundException.java, java/io/FileOutputStream.java, java/io/FilenameFilter.java, java/io/FilterInputStream.java, java/io/FilterOutputStream.java, java/io/FilterReader.java, java/io/FilterWriter.java, java/io/IOException.java, java/io/InputStream.java, java/io/InterruptedIOException.java, java/io/LineNumberInputStream.java, java/io/LineNumberReader.java, java/io/ObjectInputStream.java, java/io/ObjectStreamException.java, java/io/OptionalDataException.java, java/io/OutputStream.java, java/io/OutputStreamWriter.java, java/io/PrintStream.java, java/io/PrintWriter.java, java/io/PushbackInputStream.java, java/io/PushbackReader.java, java/io/RandomAccessFile.java, java/io/Reader.java, java/io/SequenceInputStream.java, java/io/Serializable.java, java/io/StreamCorruptedException.java, java/io/StreamTokenizer.java, java/io/StringBufferInputStream.java, java/io/StringWriter.java, java/io/SyncFailedException.java, java/io/UTFDataFormatException.java, java/io/UnsupportedEncodingException.java, java/io/WriteAbortedException.java, java/io/Writer.java, java/lang/AbstractMethodError.java, java/lang/ArithmeticException.java, java/lang/ArrayIndexOutOfBoundsException.java, java/lang/ArrayStoreException.java, java/lang/AssertionError.java, java/lang/Boolean.java, java/lang/Byte.java, java/lang/Class.java, java/lang/ClassCastException.java, java/lang/ClassCircularityError.java, java/lang/ClassLoader.java, java/lang/ClassNotFoundException.java, java/lang/CloneNotSupportedException.java, java/lang/Cloneable.java, java/lang/Comparable.java, java/lang/Compiler.java, java/lang/Double.java, java/lang/Error.java, java/lang/Exception.java, java/lang/ExceptionInInitializerError.java, java/lang/Float.java, java/lang/IllegalAccessError.java, java/lang/IllegalAccessException.java, java/lang/IllegalArgumentException.java, java/lang/IllegalMonitorStateException.java, java/lang/IllegalStateException.java, java/lang/IllegalThreadStateException.java, java/lang/IncompatibleClassChangeError.java, java/lang/IndexOutOfBoundsException.java, java/lang/InheritableThreadLocal.java, java/lang/InstantiationError.java, java/lang/InstantiationException.java, java/lang/Integer.java, java/lang/InternalError.java, java/lang/InterruptedException.java, java/lang/LinkageError.java, java/lang/Long.java, java/lang/NegativeArraySizeException.java, java/lang/NoClassDefFoundError.java, java/lang/NoSuchFieldError.java, java/lang/NoSuchFieldException.java, java/lang/NoSuchMethodError.java, java/lang/NoSuchMethodException.java, java/lang/NullPointerException.java, java/lang/Number.java, java/lang/NumberFormatException.java, java/lang/OutOfMemoryError.java, java/lang/Process.java, java/lang/Runnable.java, java/lang/Runtime.java, java/lang/RuntimeException.java, java/lang/RuntimePermission.java, java/lang/SecurityException.java, java/lang/SecurityManager.java, java/lang/Short.java, java/lang/StackOverflowError.java, java/lang/StackTraceElement.java, java/lang/StringBuffer.java, java/lang/StringIndexOutOfBoundsException.java, java/lang/ThreadDeath.java, java/lang/ThreadGroup.java, java/lang/Throwable.java, java/lang/UnsatisfiedLinkError.java, java/lang/UnsupportedOperationException.java, java/lang/VerifyError.java, java/lang/VirtualMachineError.java, java/lang/reflect/AccessibleObject.java, java/lang/reflect/Array.java, java/lang/reflect/InvocationTargetException.java, java/lang/reflect/Member.java, java/lang/reflect/Modifier.java, java/lang/reflect/Proxy.java, java/lang/reflect/ReflectPermission.java, java/lang/reflect/UndeclaredThrowableException.java, java/math/BigInteger.java, java/net/NetworkInterface.java, java/nio/ByteBufferHelper.java, java/nio/ByteBufferImpl.java, java/nio/DirectByteBufferImpl.java, java/nio/DoubleBufferImpl.java, java/nio/FloatBufferImpl.java, java/nio/IntBufferImpl.java, java/nio/LongBufferImpl.java, java/nio/ShortBufferImpl.java, java/nio/channels/Channel.java, java/nio/channels/IllegalBlockingModeException.java, java/nio/charset/spi/CharsetProvider.java, java/security/AccessControlException.java, java/security/BasicPermission.java, java/security/DigestException.java, java/security/DigestInputStream.java, java/security/DigestOutputStream.java, java/security/GeneralSecurityException.java, java/security/Guard.java, java/security/GuardedObject.java, java/security/InvalidAlgorithmParameterException.java, java/security/InvalidKeyException.java, java/security/InvalidParameterException.java, java/security/Key.java, java/security/KeyException.java, java/security/KeyManagementException.java, java/security/KeyStoreException.java, java/security/MessageDigestSpi.java, java/security/NoSuchAlgorithmException.java, java/security/NoSuchProviderException.java, java/security/Permission.java, java/security/PermissionCollection.java, java/security/Permissions.java, java/security/Principal.java, java/security/PrivateKey.java, java/security/PrivilegedActionException.java, java/security/ProviderException.java, java/security/PublicKey.java, java/security/SecureRandom.java, java/security/SecureRandomSpi.java, java/security/SignatureException.java, java/security/SignatureSpi.java, java/security/SignedObject.java, java/security/Signer.java, java/security/UnrecoverableKeyException.java, java/security/UnresolvedPermission.java, java/security/acl/AclNotFoundException.java, java/security/acl/LastOwnerException.java, java/security/acl/NotOwnerException.java, java/security/cert/CertPath.java, java/security/cert/CertPathBuilderException.java, java/security/cert/CertPathValidatorException.java, java/security/cert/CertStoreException.java, java/text/BreakIterator.java, java/text/ChoiceFormat.java, java/text/CollationElementIterator.java, java/text/CollationKey.java, java/text/Collator.java, java/text/DateFormat.java, java/text/DateFormatSymbols.java, java/text/DecimalFormat.java, java/text/DecimalFormatSymbols.java, java/text/FieldPosition.java, java/text/Format.java, java/text/NumberFormat.java, java/text/ParseException.java, java/text/ParsePosition.java, java/text/StringCharacterIterator.java, java/util/AbstractCollection.java, java/util/AbstractList.java, java/util/AbstractMap.java, java/util/AbstractSequentialList.java, java/util/AbstractSet.java, java/util/ArrayList.java, java/util/Arrays.java, java/util/BitSet.java, java/util/Collection.java, java/util/Collections.java, java/util/Comparator.java, java/util/ConcurrentModificationException.java, java/util/Currency.java, java/util/Date.java, java/util/EmptyStackException.java, java/util/Enumeration.java, java/util/EventListener.java, java/util/EventListenerProxy.java, java/util/EventObject.java, java/util/HashMap.java, java/util/HashSet.java, java/util/Hashtable.java, java/util/IdentityHashMap.java, java/util/Iterator.java, java/util/LinkedHashSet.java, java/util/LinkedList.java, java/util/List.java, java/util/ListIterator.java, java/util/ListResourceBundle.java, java/util/Map.java, java/util/MissingResourceException.java, java/util/NoSuchElementException.java, java/util/Observable.java, java/util/Observer.java, java/util/Properties.java, java/util/PropertyPermissionCollection.java, java/util/RandomAccess.java, java/util/Set.java, java/util/SortedMap.java, java/util/SortedSet.java, java/util/Stack.java, java/util/StringTokenizer.java, java/util/TooManyListenersException.java, java/util/TreeMap.java, java/util/TreeSet.java, java/util/Vector.java, java/util/logging/FileHandler.java, java/util/logging/Level.java, java/util/prefs/BackingStoreException.java, java/util/prefs/InvalidPreferencesFormatException.java, java/util/prefs/Preferences.java, javax/accessibility/Accessible.java, javax/accessibility/AccessibleAction.java, javax/accessibility/AccessibleBundle.java, javax/accessibility/AccessibleComponent.java, javax/accessibility/AccessibleContext.java, javax/accessibility/AccessibleEditableText.java, javax/accessibility/AccessibleExtendedComponent.java, javax/accessibility/AccessibleExtendedTable.java, javax/accessibility/AccessibleHyperlink.java, javax/accessibility/AccessibleHypertext.java, javax/accessibility/AccessibleIcon.java, javax/accessibility/AccessibleKeyBinding.java, javax/accessibility/AccessibleRelation.java, javax/accessibility/AccessibleRelationSet.java, javax/accessibility/AccessibleResourceBundle.java, javax/accessibility/AccessibleRole.java, javax/accessibility/AccessibleSelection.java, javax/accessibility/AccessibleState.java, javax/accessibility/AccessibleStateSet.java, javax/accessibility/AccessibleTable.java, javax/accessibility/AccessibleTableModelChange.java, javax/accessibility/AccessibleText.java, javax/accessibility/AccessibleValue.java, javax/imageio/IIOException.java, javax/imageio/ImageIO.java, javax/imageio/spi/IIOServiceProvider.java, javax/imageio/spi/ImageInputStreamSpi.java, javax/imageio/spi/ImageOutputStreamSpi.java, javax/imageio/spi/ImageReaderWriterSpi.java, javax/imageio/spi/ImageTranscoderSpi.java, javax/imageio/spi/RegisterableService.java, javax/imageio/spi/ServiceRegistry.java, javax/imageio/stream/IIOByteBuffer.java, javax/imageio/stream/ImageInputStream.java, javax/imageio/stream/ImageOutputStream.java, javax/naming/Binding.java, javax/naming/CannotProceedException.java, javax/naming/CompositeName.java, javax/naming/CompoundName.java, javax/naming/LinkException.java, javax/naming/LinkRef.java, javax/naming/NameClassPair.java, javax/naming/Reference.java, javax/naming/ReferralException.java, javax/naming/directory/Attribute.java, javax/naming/directory/AttributeModificationException.java, javax/naming/directory/Attributes.java, javax/naming/directory/DirContext.java, javax/naming/directory/ModificationItem.java, javax/naming/directory/SearchControls.java, javax/naming/directory/SearchResult.java, javax/naming/event/EventContext.java, javax/naming/event/EventDirContext.java, javax/naming/event/NamespaceChangeListener.java, javax/naming/event/NamingExceptionEvent.java, javax/naming/event/NamingListener.java, javax/naming/event/ObjectChangeListener.java, javax/naming/ldap/Control.java, javax/naming/ldap/ExtendedResponse.java, javax/naming/ldap/HasControls.java, javax/naming/ldap/LdapContext.java, javax/naming/ldap/UnsolicitedNotification.java, javax/naming/ldap/UnsolicitedNotificationEvent.java, javax/naming/ldap/UnsolicitedNotificationListener.java, javax/naming/spi/DirectoryManager.java, javax/naming/spi/ResolveResult.java, javax/naming/spi/Resolver.java, javax/security/auth/callback/Callback.java, javax/security/auth/callback/CallbackHandler.java, javax/security/auth/callback/ChoiceCallback.java, javax/security/auth/callback/ConfirmationCallback.java, javax/security/auth/callback/LanguageCallback.java, javax/security/auth/callback/NameCallback.java, javax/security/auth/callback/PasswordCallback.java, javax/security/auth/callback/TextInputCallback.java, javax/security/auth/callback/TextOutputCallback.java, javax/security/auth/callback/UnsupportedCallbackException.java, javax/security/sasl/Sasl.java, javax/security/sasl/SaslServerFactory.java, javax/swing/DefaultBoundedRangeModel.java, javax/swing/JComponent.java, javax/swing/JList.java, javax/swing/JProgressBar.java, javax/swing/JRadioButton.java, javax/swing/JTextArea.java, javax/swing/JTextField.java, javax/swing/JToggleButton.java, javax/swing/JTree.java, javax/swing/SpinnerListModel.java, javax/swing/event/EventListenerList.java, javax/swing/text/JTextComponent.java, javax/swing/text/StringContent.java, javax/swing/text/Utilities.java, javax/swing/undo/UndoManager.java, javax/swing/undo/UndoableEditSupport.java, javax/transaction/HeuristicCommitException.java, javax/transaction/HeuristicMixedException.java, javax/transaction/HeuristicRollbackException.java, javax/transaction/InvalidTransactionException.java, javax/transaction/NotSupportedException.java, javax/transaction/RollbackException.java, javax/transaction/Status.java, javax/transaction/Synchronization.java, javax/transaction/SystemException.java, javax/transaction/Transaction.java, javax/transaction/TransactionManager.java, javax/transaction/TransactionRequiredException.java, javax/transaction/TransactionRolledbackException.java, javax/transaction/UserTransaction.java, javax/transaction/xa/XAException.java, javax/transaction/xa/XAResource.java, javax/transaction/xa/Xid.java, javax/xml/XMLConstants.java, javax/xml/datatype/DatatypeConfigurationException.java, javax/xml/datatype/DatatypeConstants.java, javax/xml/datatype/DatatypeFactory.java, javax/xml/datatype/Duration.java, javax/xml/datatype/XMLGregorianCalendar.java, javax/xml/namespace/NamespaceContext.java, javax/xml/namespace/QName.java, javax/xml/parsers/DocumentBuilder.java, javax/xml/parsers/DocumentBuilderFactory.java, javax/xml/parsers/FactoryConfigurationError.java, javax/xml/parsers/ParserConfigurationException.java, javax/xml/parsers/SAXParser.java, javax/xml/parsers/SAXParserFactory.java, javax/xml/transform/ErrorListener.java, javax/xml/transform/OutputKeys.java, javax/xml/transform/Result.java, javax/xml/transform/Source.java, javax/xml/transform/SourceLocator.java, javax/xml/transform/Templates.java, javax/xml/transform/Transformer.java, javax/xml/transform/TransformerConfigurationException.java, javax/xml/transform/TransformerException.java, javax/xml/transform/TransformerFactory.java, javax/xml/transform/TransformerFactoryConfigurationError.java, javax/xml/transform/URIResolver.java, javax/xml/transform/dom/DOMLocator.java, javax/xml/transform/dom/DOMResult.java, javax/xml/transform/dom/DOMSource.java, javax/xml/transform/sax/SAXResult.java, javax/xml/transform/sax/SAXSource.java, javax/xml/transform/sax/SAXTransformerFactory.java, javax/xml/transform/sax/TemplatesHandler.java, javax/xml/transform/sax/TransformerHandler.java, javax/xml/transform/stream/StreamResult.java, javax/xml/transform/stream/StreamSource.java, javax/xml/validation/Schema.java, javax/xml/validation/SchemaFactory.java, javax/xml/validation/TypeInfoProvider.java, javax/xml/validation/Validator.java, javax/xml/validation/ValidatorHandler.java, javax/xml/xpath/XPathConstants.java, javax/xml/xpath/XPathException.java, javax/xml/xpath/XPathExpression.java, javax/xml/xpath/XPathExpressionException.java, javax/xml/xpath/XPathFactory.java, javax/xml/xpath/XPathFactoryConfigurationException.java, javax/xml/xpath/XPathFunction.java, javax/xml/xpath/XPathFunctionException.java, javax/xml/xpath/XPathFunctionResolver.java: Fixed usage of @author tag, reworked import statements, removed CVS tags, changed the modifier order and fixed HTML usage in javadocs. From-SVN: r95152
961 lines
30 KiB
Java
961 lines
30 KiB
Java
/* ServiceRegistry.java -- A simple registry for service providers.
|
|
Copyright (C) 2004, 2005 Free Software Foundation, Inc.
|
|
|
|
This file is part of GNU Classpath.
|
|
|
|
GNU Classpath is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2, or (at your option)
|
|
any later version.
|
|
|
|
GNU Classpath 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 for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with GNU Classpath; see the file COPYING. If not, write to the
|
|
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
02111-1307 USA.
|
|
|
|
Linking this library statically or dynamically with other modules is
|
|
making a combined work based on this library. Thus, the terms and
|
|
conditions of the GNU General Public License cover the whole
|
|
combination.
|
|
|
|
As a special exception, the copyright holders of this library give you
|
|
permission to link this library with independent modules to produce an
|
|
executable, regardless of the license terms of these independent
|
|
modules, and to copy and distribute the resulting executable under
|
|
terms of your choice, provided that you also meet, for each linked
|
|
independent module, the terms and conditions of the license of that
|
|
module. An independent module is a module which is not derived from
|
|
or based on this library. If you modify this library, you may extend
|
|
this exception to your version of the library, but you are not
|
|
obligated to do so. If you do not wish to do so, delete this
|
|
exception statement from your version. */
|
|
|
|
|
|
package javax.imageio.spi;
|
|
|
|
import gnu.classpath.ServiceFactory;
|
|
|
|
import java.util.ArrayList;
|
|
import java.util.Collection;
|
|
import java.util.Collections;
|
|
import java.util.Comparator;
|
|
import java.util.HashSet;
|
|
import java.util.IdentityHashMap;
|
|
import java.util.Iterator;
|
|
import java.util.LinkedList;
|
|
import java.util.Map;
|
|
import java.util.NoSuchElementException;
|
|
import java.util.Set;
|
|
|
|
/**
|
|
* A registry for service providers.
|
|
*
|
|
* @since 1.4
|
|
*
|
|
* @author Michael Koch (konqueror@gmx.de)
|
|
* @author Sascha Brawer (brawer@dandelis.ch)
|
|
*/
|
|
public class ServiceRegistry
|
|
{
|
|
// Package-private to avoid a trampoline.
|
|
/**
|
|
* The service categories of this registry.
|
|
*
|
|
* <p>Note that we expect that only very few categories will
|
|
* typically be used with a registry. The most common case will be
|
|
* one, it seems unlikely that any registry would contain more than
|
|
* five or six categories. Therefore, we intentionally avoid the
|
|
* overhead of a HashMap.
|
|
*
|
|
* @see #providers
|
|
*/
|
|
final Class[] categories;
|
|
|
|
|
|
/**
|
|
* The registered providers for each service category, indexed by
|
|
* the same index as the {@link #categories} array. If no provider
|
|
* is registered for a category, the array entry will be
|
|
* <code>null</code>.
|
|
*
|
|
* <p>Note that we expect that only very few providers will
|
|
* typically be registered for a category. The most common case will
|
|
* be one or two. Therefore, we intentionally avoid the overhead of
|
|
* a HashMap.
|
|
*/
|
|
private final LinkedList[] providers;
|
|
|
|
|
|
/**
|
|
* The ordring constaints for each service category, indexed by the
|
|
* same index as the {@link #categories} array. The constraints for
|
|
* a service category are stored as a <code>Map<Object,
|
|
* Set<Object>></code>, where the Map’s values are
|
|
* those providers that need to come after the key. If no
|
|
* constraints are imposed on the providers of a category, the array
|
|
* entry will be <code>null</code>. If no constraints have been set
|
|
* whatsoever, <code>constraints</code> will be <code>null</code>.
|
|
*
|
|
* <p>Note that we expect that only very few constraints will
|
|
* typically be imposed on a category. The most common case will
|
|
* be zero.
|
|
*/
|
|
private IdentityHashMap[] constraints;
|
|
|
|
|
|
/**
|
|
* Constructs a <code>ServiceRegistry</code> for the specified
|
|
* service categories.
|
|
*
|
|
* @param categories the categories to support
|
|
*
|
|
* @throws IllegalArgumentException if <code>categories</code> is
|
|
* <code>null</code>, or if its {@link Iterator#next()} method
|
|
* returns <code>null</code>.
|
|
*
|
|
* @throws ClassCastException if <code>categories</code> does not
|
|
* iterate over instances of {@link java.lang.Class}.
|
|
*/
|
|
public ServiceRegistry(Iterator categories)
|
|
{
|
|
ArrayList cats = new ArrayList(/* expected size */ 10);
|
|
|
|
if (categories == null)
|
|
throw new IllegalArgumentException();
|
|
|
|
while (categories.hasNext())
|
|
{
|
|
Class cat = (Class) categories.next();
|
|
if (cat == null)
|
|
throw new IllegalArgumentException();
|
|
cats.add(cat);
|
|
}
|
|
|
|
int numCats = cats.size();
|
|
this.categories = (Class[]) cats.toArray(new Class[numCats]);
|
|
this.providers = new LinkedList[numCats];
|
|
}
|
|
|
|
|
|
/**
|
|
* Finds service providers that are implementing the specified
|
|
* Service Provider Interface.
|
|
*
|
|
* <p><b>On-demand loading:</b> Loading and initializing service
|
|
* providers is delayed as much as possible. The rationale is that
|
|
* typical clients will iterate through the set of installed service
|
|
* providers until one is found that matches some criteria (like
|
|
* supported formats, or quality of service). In such scenarios, it
|
|
* might make sense to install only the frequently needed service
|
|
* providers on the local machine. More exotic providers can be put
|
|
* onto a server; the server will only be contacted when no suitable
|
|
* service could be found locally.</p>
|
|
*
|
|
* <p><b>Security considerations:</b> Any loaded service providers
|
|
* are loaded through the specified ClassLoader, or the system
|
|
* ClassLoader if <code>classLoader</code> is
|
|
* <code>null</code>. When <code>lookupProviders</code> is called,
|
|
* the current {@link java.security.AccessControlContext} gets
|
|
* recorded. This captured security context will determine the
|
|
* permissions when services get loaded via the <code>next()</code>
|
|
* method of the returned <code>Iterator</code>.</p>
|
|
*
|
|
* @param spi the service provider interface which must be
|
|
* implemented by any loaded service providers.
|
|
*
|
|
* @param loader the class loader that will be used to load the
|
|
* service providers, or <code>null</code> for the system class
|
|
* loader. For using the context class loader, see {@link
|
|
* #lookupProviders(Class)}.
|
|
*
|
|
* @return an iterator over instances of <code>spi</code>.
|
|
*
|
|
* @throws IllegalArgumentException if <code>spi</code> is
|
|
* <code>null</code>.
|
|
*/
|
|
public static Iterator lookupProviders(Class spi,
|
|
ClassLoader loader)
|
|
{
|
|
return ServiceFactory.lookupProviders(spi, loader);
|
|
}
|
|
|
|
|
|
/**
|
|
* Finds service providers that are implementing the specified
|
|
* Service Provider Interface, using the context class loader
|
|
* for loading providers.
|
|
*
|
|
* @param spi the service provider interface which must be
|
|
* implemented by any loaded service providers.
|
|
*
|
|
* @return an iterator over instances of <code>spi</code>.
|
|
*
|
|
* @throws IllegalArgumentException if <code>spi</code> is
|
|
* <code>null</code>.
|
|
*
|
|
* @see #lookupProviders(Class, ClassLoader)
|
|
*/
|
|
public static Iterator lookupProviders(Class spi)
|
|
{
|
|
return ServiceFactory.lookupProviders(spi);
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns an iterator over all service categories.
|
|
*
|
|
* @return an unmodifiable {@link
|
|
* java.util.Iterator}<{@link java.lang.Class}>.
|
|
*/
|
|
public Iterator getCategories()
|
|
{
|
|
return new Iterator()
|
|
{
|
|
int index = -1;
|
|
|
|
public boolean hasNext()
|
|
{
|
|
return index < categories.length - 1;
|
|
}
|
|
|
|
public Object next()
|
|
{
|
|
if (!hasNext())
|
|
throw new NoSuchElementException();
|
|
|
|
return categories[++index];
|
|
}
|
|
|
|
public void remove()
|
|
{
|
|
throw new UnsupportedOperationException();
|
|
}
|
|
};
|
|
}
|
|
|
|
|
|
/**
|
|
* Registers a provider for a service category which is specified by
|
|
* the class-internal category ID.
|
|
*
|
|
* @param provider the service provider to be registered.
|
|
*
|
|
* @param cat the service category, which is identified by an index
|
|
* into the {@link #categories} array.
|
|
*
|
|
* @return <code>true</code> if <code>provider</code> is the first
|
|
* provider that gets registered for the specified service category;
|
|
* <code>false</code> if other providers have already been
|
|
* registered for the same servide category.
|
|
*
|
|
* @throws IllegalArgumentException if <code>provider</code> is
|
|
* <code>null</code>.
|
|
*
|
|
* @throws ClassCastException if <code>provider</code> does not
|
|
* implement the specified service provider interface.
|
|
*/
|
|
private synchronized boolean registerServiceProvider(Object provider,
|
|
int cat)
|
|
{
|
|
LinkedList provs;
|
|
boolean result;
|
|
Class category;
|
|
|
|
if (provider == null)
|
|
throw new IllegalArgumentException();
|
|
|
|
category = categories[cat];
|
|
if (!category.isInstance(provider))
|
|
throw new ClassCastException(category.getName());
|
|
|
|
provs = providers[cat];
|
|
if (provs == null)
|
|
{
|
|
result = true;
|
|
provs = providers[cat] = new LinkedList();
|
|
}
|
|
else
|
|
result = false;
|
|
|
|
provs.add(provider);
|
|
if (provider instanceof RegisterableService)
|
|
((RegisterableService) provider).onRegistration(this, category);
|
|
|
|
return result;
|
|
}
|
|
|
|
|
|
/**
|
|
* Registers a provider for the specified service category.
|
|
*
|
|
* <p>If <code>provider</code> implements the {@link
|
|
* RegisterableService} interface, its {@link
|
|
* RegisterableService#onRegistration onRegistration} method is
|
|
* invoked in order to inform the provider about the addition to
|
|
* this registry.
|
|
*
|
|
* @param provider the service provider to be registered.
|
|
*
|
|
* @param category the service category under which
|
|
* <code>provider</code> shall be registered.
|
|
*
|
|
* @return <code>true</code> if <code>provider</code> is the first
|
|
* provider that gets registered for the specified service category;
|
|
* <code>false</code> if other providers have already been
|
|
* registered for the same servide category.
|
|
*
|
|
* @throws IllegalArgumentException if <code>provider</code> is
|
|
* <code>null</code>, or if <code>category</code> is not among the
|
|
* categories passed to the {@linkplain #ServiceRegistry(Iterator)
|
|
* constructor} of this ServiceRegistry.
|
|
*
|
|
* @throws ClassCastException if <code>provider</code> does not
|
|
* implement <code>category</code>.
|
|
*/
|
|
public synchronized boolean registerServiceProvider(Object provider,
|
|
Class category)
|
|
{
|
|
for (int i = 0; i < categories.length; i++)
|
|
if (categories[i] == category)
|
|
return registerServiceProvider(provider, i);
|
|
throw new IllegalArgumentException();
|
|
}
|
|
|
|
|
|
/**
|
|
* Registers a provider under all service categories it
|
|
* implements.
|
|
*
|
|
* <p>If <code>provider</code> implements the {@link
|
|
* RegisterableService} interface, its {@link
|
|
* RegisterableService#onRegistration onRegistration} method is
|
|
* invoked in order to inform the provider about the addition to
|
|
* this registry. If <code>provider</code> implements several
|
|
* service categories, <code>onRegistration</code> gets called
|
|
* multiple times.
|
|
*
|
|
* @param provider the service provider to be registered.
|
|
*
|
|
* @throws IllegalArgumentException if <code>provider</code> is
|
|
* <code>null</code>, or if <code>provider</code> does not implement
|
|
* any of the service categories passed to the {@linkplain
|
|
* #ServiceRegistry(Iterator) constructor} of this ServiceRegistry.
|
|
*/
|
|
public synchronized void registerServiceProvider(Object provider)
|
|
{
|
|
boolean ok = false;
|
|
|
|
if (provider == null)
|
|
throw new IllegalArgumentException();
|
|
|
|
for (int i = 0; i < categories.length; i++)
|
|
if (categories[i].isInstance(provider))
|
|
{
|
|
ok = true;
|
|
registerServiceProvider(provider, i);
|
|
}
|
|
|
|
if (!ok)
|
|
throw new IllegalArgumentException();
|
|
}
|
|
|
|
|
|
/**
|
|
* Registers a number of providers under all service categories they
|
|
* implement.
|
|
*
|
|
* <p>If a provider implements the {@link RegisterableService}
|
|
* interface, its {@link RegisterableService#onRegistration
|
|
* onRegistration} method is invoked in order to inform the provider
|
|
* about the addition to this registry. If <code>provider</code>
|
|
* implements several service categories,
|
|
* <code>onRegistration</code> gets called multiple times.
|
|
*
|
|
* @throws IllegalArgumentException if <code>providers</code> is
|
|
* <code>null</code>, if any iterated provider is <code>null</code>,
|
|
* or if some iterated provider does not implement any of the
|
|
* service categories passed to the {@linkplain
|
|
* #ServiceRegistry(Iterator) constructor} of this
|
|
* <code>ServiceRegistry</code>.
|
|
*/
|
|
public synchronized void registerServiceProviders(Iterator providers)
|
|
{
|
|
if (providers == null)
|
|
throw new IllegalArgumentException();
|
|
|
|
while (providers.hasNext())
|
|
registerServiceProvider(providers.next());
|
|
}
|
|
|
|
|
|
/**
|
|
* De-registers a provider for a service category which is specified
|
|
* by the class-internal category ID.
|
|
*
|
|
* @param provider the service provider to be registered.
|
|
*
|
|
* @param cat the service category, which is identified by an index
|
|
* into the {@link #categories} array.
|
|
*
|
|
* @return <code>true</code> if <code>provider</code> was previously
|
|
* registered for the specified service category; <code>false</code>
|
|
* if if the provider had not been registered.
|
|
*
|
|
* @throws IllegalArgumentException if <code>provider</code> is
|
|
* <code>null</code>.
|
|
*
|
|
* @throws ClassCastException if <code>provider</code> does not
|
|
* implement the specified service provider interface.
|
|
*/
|
|
private synchronized boolean deregisterServiceProvider(Object provider,
|
|
int cat)
|
|
{
|
|
LinkedList provs;
|
|
boolean result;
|
|
Class category;
|
|
|
|
if (provider == null)
|
|
throw new IllegalArgumentException();
|
|
|
|
category = categories[cat];
|
|
if (!category.isInstance(provider))
|
|
throw new ClassCastException(category.getName());
|
|
|
|
provs = providers[cat];
|
|
if (provs == null)
|
|
return false;
|
|
|
|
result = provs.remove(provider);
|
|
if (provs.isEmpty())
|
|
providers[cat] = null;
|
|
|
|
if (result && (provider instanceof RegisterableService))
|
|
((RegisterableService) provider).onDeregistration(this, category);
|
|
|
|
return result;
|
|
}
|
|
|
|
|
|
/**
|
|
* De-registers a provider for the specified service category.
|
|
*
|
|
* <p>If <code>provider</code> implements the {@link
|
|
* RegisterableService} interface, its {@link
|
|
* RegisterableService#onDeregistration onDeregistration} method is
|
|
* invoked in order to inform the provider about the removal from
|
|
* this registry.
|
|
*
|
|
* @param provider the service provider to be de-registered.
|
|
*
|
|
* @param category the service category from which
|
|
* <code>provider</code> shall be de-registered.
|
|
*
|
|
* @return <code>true</code> if <code>provider</code> was previously
|
|
* registered for the specified service category; <code>false</code>
|
|
* if if the provider had not been registered.
|
|
*
|
|
* @throws IllegalArgumentException if <code>provider</code> is
|
|
* <code>null</code>, or if <code>category</code> is not among the
|
|
* categories passed to the {@linkplain #ServiceRegistry(Iterator)
|
|
* constructor} of this ServiceRegistry.
|
|
*
|
|
* @throws ClassCastException if <code>provider</code> does not
|
|
* implement <code>category</code>.
|
|
*/
|
|
public synchronized boolean deregisterServiceProvider(Object provider,
|
|
Class category)
|
|
{
|
|
for (int i = 0; i < categories.length; i++)
|
|
if (categories[i] == category)
|
|
return deregisterServiceProvider(provider, i);
|
|
throw new IllegalArgumentException();
|
|
}
|
|
|
|
|
|
/**
|
|
* De-registers a provider from all service categories it
|
|
* implements.
|
|
*
|
|
* <p>If <code>provider</code> implements the {@link
|
|
* RegisterableService} interface, its {@link
|
|
* RegisterableService#onDeregistration onDeregistration} method is
|
|
* invoked in order to inform the provider about the removal from
|
|
* this registry. If <code>provider</code> implements several
|
|
* service categories, <code>onDeregistration</code> gets called
|
|
* multiple times.</p>
|
|
*
|
|
* @param provider the service provider to be de-registered.
|
|
*
|
|
* @throws IllegalArgumentException if <code>provider</code> is
|
|
* <code>null</code>, or if <code>provider</code> does not implement
|
|
* any of the service categories passed to the {@linkplain
|
|
* #ServiceRegistry(Iterator) constructor} of this
|
|
* <code>ServiceRegistry</code>.
|
|
*/
|
|
public synchronized void deregisterServiceProvider(Object provider)
|
|
{
|
|
boolean ok = false;
|
|
|
|
if (provider == null)
|
|
throw new IllegalArgumentException();
|
|
|
|
for (int i = 0; i < categories.length; i++)
|
|
if (categories[i].isInstance(provider))
|
|
{
|
|
ok = true;
|
|
deregisterServiceProvider(provider, i);
|
|
}
|
|
|
|
if (!ok)
|
|
throw new IllegalArgumentException();
|
|
}
|
|
|
|
|
|
/**
|
|
* De-registers all providers which have been registered for the
|
|
* specified service category.
|
|
*
|
|
* <p>If a provider implements the {@link RegisterableService}
|
|
* interface, its {@link RegisterableService#onDeregistration
|
|
* onDeregistration} method is invoked in order to inform the
|
|
* provider about the removal from this registry. If the provider
|
|
* implements several service categories,
|
|
* <code>onDeregistration</code> gets called multiple times.
|
|
*
|
|
* @param category the category whose registered providers will be
|
|
* de-registered.
|
|
*
|
|
* @throws IllegalArgumentException if <code>category</code> is not
|
|
* among the categories passed to the {@linkplain
|
|
* #ServiceRegistry(Iterator) constructor} of this
|
|
* <code>ServiceRegistry</code>.
|
|
*/
|
|
public synchronized void deregisterAll(Class category)
|
|
{
|
|
boolean ok = false;
|
|
|
|
for (int i = 0; i < categories.length; i++)
|
|
{
|
|
if (categories[i] != category)
|
|
continue;
|
|
|
|
ok = true;
|
|
while (providers[i] != null)
|
|
deregisterServiceProvider(providers[i].get(0), i);
|
|
}
|
|
|
|
if (!ok)
|
|
throw new IllegalArgumentException();
|
|
}
|
|
|
|
|
|
/**
|
|
* De-registers all service providers.
|
|
*
|
|
* <p>If a provider implements the {@link RegisterableService}
|
|
* interface, its {@link RegisterableService#onDeregistration
|
|
* onDeregistration} method is invoked in order to inform the
|
|
* provider about the removal from this registry. If the provider
|
|
* implements several service categories,
|
|
* <code>onDeregistration</code> gets called multiple times.
|
|
*/
|
|
public synchronized void deregisterAll()
|
|
{
|
|
for (int i = 0; i < categories.length; i++)
|
|
while (providers[i] != null)
|
|
deregisterServiceProvider(providers[i].get(0), i);
|
|
}
|
|
|
|
|
|
/**
|
|
* Called by the Virtual Machine when it detects that this
|
|
* <code>ServiceRegistry</code> has become garbage. De-registers all
|
|
* service providers, which will cause those that implement {@link
|
|
* RegisterableService} to receive a {@link
|
|
* RegisterableService#onDeregistration onDeregistration}
|
|
* notification.
|
|
*/
|
|
public void finalize()
|
|
throws Throwable
|
|
{
|
|
super.finalize();
|
|
deregisterAll();
|
|
}
|
|
|
|
|
|
/**
|
|
* Determines whether a provider has been registered with this
|
|
* registry.
|
|
*
|
|
* @return <code>true</code> if <code>provider</code> has been
|
|
* registered under any service category; <code>false</code> if
|
|
* it is not registered.
|
|
*
|
|
* @throws IllegalArgumentException if <code>provider</code> is
|
|
* <code>null</code>.
|
|
*/
|
|
public synchronized boolean contains(Object provider)
|
|
{
|
|
if (provider == null)
|
|
throw new IllegalArgumentException();
|
|
|
|
// Note that contains is rather unlikely to be ever called,
|
|
// so it would be wasteful to keep a special data structure
|
|
// (such as a HashSet) for making it a fast operation.
|
|
for (int i = 0; i < providers.length; i++)
|
|
{
|
|
// If provider does not implement categories[i],
|
|
// it would not have been possible to register it there.
|
|
// In that case, it would be pointless to look there.
|
|
if (!categories[i].isInstance(provider))
|
|
continue;
|
|
|
|
// But if the list of registered providers contains provider,
|
|
// we have found it.
|
|
LinkedList p = providers[i];
|
|
if (p != null && p.contains(provider))
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns the index in {@link #categories} occupied by the
|
|
* specified service category.
|
|
*
|
|
* @throws IllegalArgumentException if <code>category</code> is not
|
|
* among the categories passed to the {@linkplain
|
|
* #ServiceRegistry(Iterator) constructor} of this ServiceRegistry.
|
|
*/
|
|
private int getCategoryID(Class category)
|
|
{
|
|
for (int i = 0; i < categories.length; i++)
|
|
if (categories[i] == category)
|
|
return i;
|
|
|
|
throw new IllegalArgumentException();
|
|
}
|
|
|
|
|
|
/**
|
|
* Retrieves all providers that have been registered for the
|
|
* specified service category.
|
|
*
|
|
* @param category the service category whose providers are
|
|
* to be retrieved.
|
|
*
|
|
* @param useOrdering <code>true</code> in order to retrieve the
|
|
* providers in an order imposed by the {@linkplain #setOrdering
|
|
* ordering constraints}; <code>false</code> in order to retrieve
|
|
* the providers in any order.
|
|
*
|
|
* @throws IllegalArgumentException if <code>category</code> is not
|
|
* among the categories passed to the {@linkplain
|
|
* #ServiceRegistry(Iterator) constructor} of this
|
|
* <code>ServiceRegistry</code>.
|
|
*
|
|
* @see #getServiceProviders(Class, Filter, boolean)
|
|
*/
|
|
public Iterator getServiceProviders(Class category, boolean useOrdering)
|
|
{
|
|
return getServiceProviders(category, null, useOrdering);
|
|
}
|
|
|
|
|
|
/**
|
|
* Retrieves all providers that have been registered for the
|
|
* specified service category and that satisfy the criteria
|
|
* of a custom filter.
|
|
*
|
|
* @param category the service category whose providers are
|
|
* to be retrieved.
|
|
*
|
|
* @param filter a custom filter, or <code>null</code> to
|
|
* retrieve all registered providers for the specified
|
|
* category.
|
|
*
|
|
* @param useOrdering <code>true</code> in order to retrieve the
|
|
* providers in an order imposed by the {@linkplain #setOrdering
|
|
* ordering constraints}; <code>false</code> in order to retrieve
|
|
* the providers in any order.
|
|
*
|
|
* @throws IllegalArgumentException if <code>category</code> is not
|
|
* among the categories passed to the {@linkplain
|
|
* #ServiceRegistry(Iterator) constructor} of this
|
|
* <code>ServiceRegistry</code>.
|
|
*/
|
|
public synchronized Iterator getServiceProviders(Class category,
|
|
Filter filter,
|
|
boolean useOrdering)
|
|
{
|
|
int catid;
|
|
LinkedList provs;
|
|
ArrayList result;
|
|
|
|
catid = getCategoryID(category);
|
|
provs = providers[catid];
|
|
if (provs == null)
|
|
return Collections.EMPTY_LIST.iterator();
|
|
|
|
result = new ArrayList(provs.size());
|
|
for (Iterator iter = provs.iterator(); iter.hasNext();)
|
|
{
|
|
Object provider = iter.next();
|
|
if (filter == null || filter.filter(provider))
|
|
result.add(provider);
|
|
}
|
|
|
|
// If we are supposed to obey ordering constraints, and
|
|
// if any constraints have been imposed on the specified
|
|
// service category, sort the result.
|
|
if (useOrdering && constraints != null)
|
|
{
|
|
final Map cons = constraints[catid];
|
|
if (cons != null)
|
|
Collections.sort(result, new Comparator()
|
|
{
|
|
public int compare(Object o1, Object o2)
|
|
{
|
|
Set s;
|
|
|
|
if (o1 == o2)
|
|
return 0;
|
|
|
|
s = (Set) cons.get(o1);
|
|
if (s != null && s.contains(o2))
|
|
return -1; // o1 < o2
|
|
|
|
s = (Set) cons.get(o2);
|
|
if (s != null && s.contains(o1))
|
|
return 1; // o1 > o2
|
|
|
|
return 0; // o1 == o2
|
|
}
|
|
});
|
|
}
|
|
|
|
return result.iterator();
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns one of the service providers that is a subclass of the
|
|
* specified class.
|
|
*
|
|
* @param providerClass a class to search for.
|
|
*/
|
|
public synchronized Object getServiceProviderByClass(Class providerClass)
|
|
{
|
|
if (providerClass == null)
|
|
throw new IllegalArgumentException();
|
|
|
|
// Note that the method getServiceProviderByClass is rather
|
|
// unlikely to be ever called, so it would be wasteful to keep a
|
|
// special data structure for making it a fast operation.
|
|
for (int cat = 0; cat < categories.length; cat++)
|
|
{
|
|
if (!categories[cat].isAssignableFrom(providerClass))
|
|
continue;
|
|
|
|
LinkedList provs = providers[cat];
|
|
if (provs == null)
|
|
continue;
|
|
|
|
for (Iterator iter = provs.iterator(); iter.hasNext();)
|
|
{
|
|
Object provider = iter.next();
|
|
if (providerClass.isInstance(provider))
|
|
return provider;
|
|
}
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
|
|
/**
|
|
* Adds an ordering constraint on service providers.
|
|
*
|
|
* @param category the service category to which an ordering
|
|
* constraint is to be added.
|
|
*
|
|
* @param first the provider which is supposed to come before
|
|
* <code>second</code>.
|
|
*
|
|
* @param second the provider which is supposed to come after
|
|
* <code>first</code>.
|
|
*
|
|
* @throws IllegalArgumentException if <code>first</code> and
|
|
* <code>second</code> are referring to the same object, or if one
|
|
* of them is <code>null</code>.
|
|
*
|
|
* @see #unsetOrdering
|
|
* @see #getServiceProviders(Class, Filter, boolean)
|
|
*/
|
|
public synchronized boolean setOrdering(Class category,
|
|
Object firstProvider,
|
|
Object secondProvider)
|
|
{
|
|
return addConstraint(getCategoryID(category), firstProvider,
|
|
secondProvider);
|
|
}
|
|
|
|
|
|
/**
|
|
* Removes an ordering constraint on service providers.
|
|
*
|
|
* @param category the service category from which an ordering
|
|
* constraint is to be removed.
|
|
*
|
|
* @param first the provider which is supposed to come before
|
|
* <code>second</code>.
|
|
*
|
|
* @param second the provider which is supposed to come after
|
|
* <code>first</code>.
|
|
*
|
|
* @throws IllegalArgumentException if <code>first</code> and
|
|
* <code>second</code> are referring to the same object, or if one
|
|
* of them is <code>null</code>.
|
|
*
|
|
* @see #setOrdering
|
|
*/
|
|
public synchronized boolean unsetOrdering(Class category,
|
|
Object firstProvider,
|
|
Object secondProvider)
|
|
{
|
|
return removeConstraint(getCategoryID(category),
|
|
firstProvider, secondProvider);
|
|
}
|
|
|
|
|
|
/**
|
|
* Adds an ordering constraint on service providers.
|
|
*
|
|
* @param catid the service category ID, which is the
|
|
* category’s index into the {@link #categories} array.
|
|
*
|
|
* @param first the provider which is supposed to come before
|
|
* <code>second</code>.
|
|
*
|
|
* @param second the provider which is supposed to come after
|
|
* <code>first</code>.
|
|
*
|
|
* @throws IllegalArgumentException if <code>first</code> and
|
|
* <code>second</code> are referring to the same object, or if one
|
|
* of them is <code>null</code>.
|
|
*/
|
|
private boolean addConstraint(int catid, Object first, Object second)
|
|
{
|
|
Set s;
|
|
IdentityHashMap cons;
|
|
|
|
// Also checks argument validity.
|
|
removeConstraint(catid, second, first);
|
|
|
|
if (constraints == null)
|
|
constraints = new IdentityHashMap[categories.length];
|
|
cons = constraints[catid];
|
|
if (cons == null)
|
|
cons = constraints[catid] = new IdentityHashMap();
|
|
|
|
s = (Set) cons.get(first);
|
|
if (s == null)
|
|
cons.put(first, s = new HashSet());
|
|
return s.add(second);
|
|
}
|
|
|
|
|
|
/**
|
|
* Removes an ordering constraint on service providers.
|
|
*
|
|
* @param catid the service category ID, which is the
|
|
* category’s index into the {@link #categories} array.
|
|
*
|
|
* @param first the provider which is supposed to come before
|
|
* <code>second</code>.
|
|
*
|
|
* @param second the provider which is supposed to come after
|
|
* <code>first</code>.
|
|
*
|
|
* @throws IllegalArgumentException if <code>first</code> and
|
|
* <code>second</code> are referring to the same object, or if one
|
|
* of them is <code>null</code>.
|
|
*/
|
|
private boolean removeConstraint(int catid, Object first, Object second)
|
|
{
|
|
Collection s;
|
|
IdentityHashMap cons;
|
|
|
|
if (first == null || second == null || first == second)
|
|
throw new IllegalArgumentException();
|
|
|
|
if (constraints == null)
|
|
return false;
|
|
|
|
cons = constraints[catid];
|
|
if (cons == null)
|
|
return false;
|
|
|
|
s = (Collection) cons.get(first);
|
|
if (s == null)
|
|
return false;
|
|
|
|
if (!s.remove(second))
|
|
return false;
|
|
|
|
// If we removed the last constraint for a service category,
|
|
// we can get free some memory.
|
|
if (cons.isEmpty())
|
|
{
|
|
constraints[catid] = null;
|
|
boolean anyConstraints = false;
|
|
for (int i = 0; i < constraints.length; i++)
|
|
{
|
|
if (constraints[i] != null)
|
|
{
|
|
anyConstraints = true;
|
|
break;
|
|
}
|
|
}
|
|
if (!anyConstraints)
|
|
constraints = null;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
/**
|
|
* A filter for selecting service providers that match custom
|
|
* criteria.
|
|
*
|
|
* @see ServiceRegistry#getServiceProviders(Class, Filter,
|
|
* boolean)
|
|
*
|
|
* @since 1.4
|
|
*
|
|
* @author Michael Koch (konqueror@gmx.de)
|
|
* @author Sascha Brawer (brawer@dandelis.ch)
|
|
*/
|
|
public static interface Filter
|
|
{
|
|
/**
|
|
* Checks whether the specified service provider matches the
|
|
* constraints of this Filter.
|
|
*
|
|
* @param provider the service provider in question.
|
|
*
|
|
* @return <code>true</code> if <code>provider</code> matches the
|
|
* criteria; <code>false</code> if it does not match.
|
|
*/
|
|
boolean filter(Object provider);
|
|
};
|
|
}
|
|
|