OpenSearch Impl

- addition of icons (for search engine, feed and feed entries)
- configurable items per page
- addition of feed entry relevance (score) (ATOM only)
- addition for generator & author feed elements (ATOM only)
- guest url argument support
- logging (log4j.logger.org.alfresco.web.api=DEBUG)
- addition of abstract web api plug-in (for building new url web services)

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@4668 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/web/api/APIServiceRegistry.java

@@ -0,0 +1,118 @@
+/*
+ * Copyright (C) 2005 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * 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.alfresco.web.api;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+import javax.servlet.ServletContext;
+
+import org.aopalliance.intercept.MethodInterceptor;
+import org.springframework.aop.framework.ProxyFactory;
+import org.springframework.aop.support.RegexpMethodPointcutAdvisor;
+import org.springframework.context.ApplicationContext;
+
+
+/**
+ * Registry of Web API Services methods
+ * 
+ * @author davidc
+ */
+public class APIServiceRegistry
+{
+    // TODO: Support different kinds of uri resolution (e.g. regex:/search/.*)
+    
+    private List<APIRequest.HttpMethod> methods = new ArrayList<APIRequest.HttpMethod>();
+    private List<String> uris = new ArrayList<String>();
+    private List<APIService> services = new ArrayList<APIService>();
+    
+    
+    /**
+     * Construct list of API Services
+     * 
+     * @param context
+     */
+    public APIServiceRegistry(ServletContext servletContext, ApplicationContext appContext)
+    {
+        // retrieve service authenticator
+        MethodInterceptor authenticator = (MethodInterceptor)appContext.getBean("web.api.Authenticator");
+
+        // register all API Services
+        // NOTE: An API Service is one registered in Spring which is of type APIServiceImpl
+        Map<String, APIService> apiServices = appContext.getBeansOfType(APIService.class, false, false);
+        for (Map.Entry<String, APIService> apiService : apiServices.entrySet())
+        {
+            // retrieve service
+            APIService service = apiService.getValue();
+            service.init(servletContext);
+            
+            // retrieve http method
+            APIRequest.HttpMethod method = service.getHttpMethod();
+            String httpUri = service.getHttpUri();
+            if (httpUri == null || httpUri.length() == 0)
+            {
+                throw new APIException("Web API Service " + apiService.getKey() + " does not specify a HTTP URI mapping");
+            }
+            
+            // wrap API Service in appropriate interceptors (e.g. authentication)
+            if (service.getRequiredAuthentication() != APIRequest.RequiredAuthentication.None)
+            {
+                if (authenticator == null)
+                {
+                    throw new APIException("Web API Authenticator not specified");
+                }
+                
+                RegexpMethodPointcutAdvisor advisor = new RegexpMethodPointcutAdvisor(".*execute", authenticator);
+                ProxyFactory authFactory = new ProxyFactory((APIService)service);
+                authFactory.addAdvisor(advisor);
+                service = (APIService)authFactory.getProxy();
+            }
+                        
+            // register service
+            methods.add(method);
+            uris.add(httpUri);
+            services.add(service);
+        }
+    }
+    
+    
+    /**
+     * Gets an API Service given an HTTP Method and URI
+     * 
+     * @param method
+     * @param uri
+     * @return
+     */
+    public APIService get(APIRequest.HttpMethod method, String uri)
+    {
+        APIService apiService = null;
+
+        // TODO: Replace with more efficient approach
+        for (int i = 0; i < services.size(); i++)
+        {
+            if (methods.get(i).equals(method) && uris.get(i).equals(uri))
+            {
+                apiService = services.get(i);
+                break;
+            }
+        }
+        
+        return apiService;
+    }
+    
+}