svn commit: r982579 - /openwebbeans/trunk/webbeans-spi/src/main/java/org/apache/webbeans/spi/SingletonService.java

[ge...@apache.org]

Author: gerdogdu
Date: Thu Aug  5 12:37:21 2010
New Revision: 982579

URL: http://svn.apache.org/viewvc?rev=982579&view=rev
Log:
[OWB-432] Create Singleton Service SPI

Added:
    openwebbeans/trunk/webbeans-spi/src/main/java/org/apache/webbeans/spi/SingletonService.java   (with props)

Added: openwebbeans/trunk/webbeans-spi/src/main/java/org/apache/webbeans/spi/SingletonService.java
URL: http://svn.apache.org/viewvc/openwebbeans/trunk/webbeans-spi/src/main/java/org/apache/webbeans/spi/SingletonService.java?rev=982579&view=auto
==============================================================================
--- openwebbeans/trunk/webbeans-spi/src/main/java/org/apache/webbeans/spi/SingletonService.java (added)
+++ openwebbeans/trunk/webbeans-spi/src/main/java/org/apache/webbeans/spi/SingletonService.java Thu Aug  5 12:37:21 2010
@@ -0,0 +1,69 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you 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.
+ */
+package org.apache.webbeans.spi;
+
+/**
+ * 
+ * Responsible for providing singleton instances
+ * for OWB runtime. Provider can implement
+ * their own logic to provide singleton instances.
+ * 
+ * @version $Rev$ $Date$
+ */
+public interface SingletonService
+{
+    /**
+     * Get instance for given key and class name.
+     * @param key instance key
+     * @param singletonClassName instance class name
+     * @return instance
+     */
+    public Object get(Object key, String singletonClassName);
+    
+    /**
+     * Any clean activity.
+     * @param key instance key
+     */
+    public void clear(Object key);
+    
+    /**
+     * Returns true if singleton exist,
+     * false otherwise.
+     * @param key instance key
+     * @param singletonClassName class name
+     * @return true if singleton exist
+     */
+    public boolean isExist(Object key, String singletonClassName);
+    
+    /**
+     * Returns exist instance or null.
+     * @param key instance key
+     * @param singletonClassName class name
+     * @return exist instance
+     */
+    public Object getExist(Object key, String singletonClassName);
+    
+    /**
+     * Returns key for the given singleton
+     * instance.
+     * @param singleton instance
+     * @return key for given instance
+     */
+    public Object getKey(Object singleton);
+}

Propchange: openwebbeans/trunk/webbeans-spi/src/main/java/org/apache/webbeans/spi/SingletonService.java
------------------------------------------------------------------------------
    svn:eol-style = native