--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/org.eclipse.osgi/osgi/src/org/osgi/framework/ServiceRegistration.d	Sat Apr 18 13:58:35 2009 +0200
@@ -0,0 +1,115 @@
+/*
+ * $Header: /cvshome/build/org.osgi.framework/src/org/osgi/framework/ServiceRegistration.java,v 1.14 2007/02/21 16:49:05 hargrave Exp $
+ * 
+ * Copyright (c) OSGi Alliance (2000, 2007). All Rights Reserved.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+module org.osgi.framework.ServiceRegistration;
+import org.osgi.framework.ServiceReference;
+
+import java.lang.all;
+import java.util.Dictionary;
+
+/**
+ * A registered service.
+ * 
+ * <p>
+ * The Framework returns a <code>ServiceRegistration</code> object when a
+ * <code>BundleContext.registerService</code> method invocation is successful.
+ * The <code>ServiceRegistration</code> object is for the private use of the
+ * registering bundle and should not be shared with other bundles.
+ * <p>
+ * The <code>ServiceRegistration</code> object may be used to update the
+ * properties of the service or to unregister the service.
+ * 
+ * @see BundleContext#registerService(String[],Object,Dictionary)
+ * @ThreadSafe
+ * @version $Revision: 1.14 $
+ */
+
+public interface ServiceRegistration {
+    /**
+     * Returns a <code>ServiceReference</code> object for a service being
+     * registered.
+     * <p>
+     * The <code>ServiceReference</code> object may be shared with other
+     * bundles.
+     * 
+     * @throws java.lang.IllegalStateException If this
+     *         <code>ServiceRegistration</code> object has already been
+     *         unregistered.
+     * @return <code>ServiceReference</code> object.
+     */
+    public ServiceReference getReference();
+
+    /**
+     * Updates the properties associated with a service.
+     * 
+     * <p>
+     * The {@link Constants#OBJECTCLASS} and {@link Constants#SERVICE_ID} keys
+     * cannot be modified by this method. These values are set by the Framework
+     * when the service is registered in the OSGi environment.
+     * 
+     * <p>
+     * The following steps are required to modify service properties:
+     * <ol>
+     * <li>The service's properties are replaced with the provided properties.
+     * <li>A service event of type {@link ServiceEvent#MODIFIED} is
+     * fired.
+     * </ol>
+     * 
+     * @param properties The properties for this service. See {@link Constants}
+     *        for a list of standard service property keys. Changes should not
+     *        be made to this object after calling this method. To update the
+     *        service's properties this method should be called again.
+     * 
+     * @throws IllegalStateException If this <code>ServiceRegistration</code>
+     *         object has already been unregistered.
+     * @throws IllegalArgumentException If <code>properties</code> contains
+     *         case variants of the same key name.
+     */
+    public void setProperties(Dictionary properties);
+
+    /**
+     * Unregisters a service. Remove a <code>ServiceRegistration</code> object
+     * from the Framework service registry. All <code>ServiceReference</code>
+     * objects associated with this <code>ServiceRegistration</code> object
+     * can no longer be used to interact with the service.
+     * 
+     * <p>
+     * The following steps are required to unregister a service:
+     * <ol>
+     * <li>The service is removed from the Framework service registry so that
+     * it can no longer be used. <code>ServiceReference</code> objects for the
+     * service may no longer be used to get a service object for the service.
+     * <li>A service event of type {@link ServiceEvent#UNREGISTERING} is
+     * fired so that bundles using this service can release their
+     * use of it.
+     * <li>For each bundle whose use count for this service is greater than
+     * zero: <br>
+     * The bundle's use count for this service is set to zero. <br>
+     * If the service was registered with a {@link ServiceFactory} object, the
+     * <code>ServiceFactory.ungetService</code> method is called to release
+     * the service object for the bundle.
+     * </ol>
+     * 
+     * @throws java.lang.IllegalStateException If this
+     *         <code>ServiceRegistration</code> object has already been
+     *         unregistered.
+     * @see BundleContext#ungetService
+     * @see ServiceFactory#ungetService
+     */
+    public void unregister();
+}