1 /* 2 * Copyright 2001-2008 The Apache Software Foundation. 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 * 16 */ 17 18 package org.apache.juddi.query; 19 20 import java.util.List; 21 22 import javax.persistence.EntityManager; 23 24 import org.apache.juddi.query.util.DynamicQuery; 25 import org.apache.juddi.query.util.FindQualifiers; 26 import org.uddi.api_v3.CategoryBag; 27 28 /** 29 * Returns the list of service keys possessing the keyedReferenceGroups in the passed category bag. 30 * Output is restricted by list of service keys passed in. If null, all services are searched. 31 * Output is produced by building the appropriate JPA query based on input and find qualifiers. 32 * 33 * From specification: 34 * "This is a list of category references. The returned serviceList contains serviceInfo structures matching all of the 35 * categories passed (logical AND by default). Specifying the appropriate findQualifiers can override this behavior. 36 * 37 * A given keyedReferenceGroup "X" (e.g., within a given categoryBag) matches a keyedReferenceGroup "Y" in the registry if 38 * and only if the tModelKey assigned to the keyedReferenceGroup X matches the tModelKey assigned to the keyedReferenceGroup 39 * Y and the set of keyedReferences in "X" are a subset of the set of keyedReferences in "Y." The order of individual 40 * keyedReferences within a keyedReferenceGroup is not important. Matching rules for the individual contained keyedReference 41 * elements are the same as above." 42 * 43 * @author <a href="mailto:jfaath@apache.org">Jeff Faath</a> 44 */ 45 public class FindServiceByCategoryGroupQuery { 46 47 private static final String ENTITY_NAME_CHILD = "ServiceCategoryBag"; 48 49 private static final FindEntityByCategoryGroupQuery findQuery; 50 51 static { 52 findQuery = new FindEntityByCategoryGroupQuery(BusinessServiceQuery.ENTITY_NAME, 53 BusinessServiceQuery.ENTITY_ALIAS, 54 BusinessServiceQuery.KEY_NAME, 55 BusinessServiceQuery.ENTITY_FIELD, 56 ENTITY_NAME_CHILD, 57 BusinessServiceQuery.SIGNATURE_PRESENT); 58 } 59 60 public static List<Object> select(EntityManager em, FindQualifiers fq, CategoryBag categoryBag, String parentKey, List<Object> keysIn) { 61 if (parentKey != null && parentKey.length() > 0) { 62 DynamicQuery.Parameter param = new DynamicQuery.Parameter(BusinessServiceQuery.ENTITY_ALIAS + "." + BusinessServiceQuery.KEY_NAME_PARENT, parentKey, DynamicQuery.PREDICATE_EQUALS); 63 return findQuery.select(em, fq, categoryBag, keysIn, param); 64 } 65 else 66 return findQuery.select(em, fq, categoryBag, keysIn); 67 } 68 }