summaryrefslogtreecommitdiffstats
path: root/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactoryFinder.java
blob: d9cd78042499fb0c584b0850f56fd4e27eb753f5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
/*
 * Copyright(C) OASIS(R) 2005,2009. All Rights Reserved.
 * OASIS trademark, IPR and other policies apply.
 */

package org.oasisopen.sca.client;

import java.net.URI;
import java.util.Properties;

import org.oasisopen.sca.NoSuchDomainException;

/* A Service Provider Interface representing a SCAClientFactory finder.  
 * SCA provides a default reference implementation of this interface.
 * SCA runtime vendors can create alternative implementations of this 
 * interface that use different class loading or lookup mechanisms.
 */
public interface SCAClientFactoryFinder {

        /**
         * Method for finding the SCAClientFactory for a given Domain URI using
         * a specified set of properties and a a specified ClassLoader
         * @param properties - properties to use - may be null
         * @param classLoader - ClassLoader to use - may be null
         * @param domainURI - the Domain URI - must be a valid SCA Domain URI
         * @return - the SCAClientFactory or null if the factory could not be
         * @throws - NoSuchDomainException if the domainURI does not reference 
         * a valid SCA Domain 
         * found
         */
    SCAClientFactory find(Properties properties,
                          ClassLoader classLoader,
                          URI domainURI ) 
        throws NoSuchDomainException ;
}