175 lines
7.4 KiB
Java
175 lines
7.4 KiB
Java
/*************************************************************************
|
|
*
|
|
* The Contents of this file are made available subject to the terms of
|
|
* the BSD license.
|
|
*
|
|
* Copyright 2000, 2010 Oracle and/or its affiliates.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. Neither the name of Sun Microsystems, Inc. nor the names of its
|
|
* contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
|
|
* TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
|
|
* USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
*************************************************************************/
|
|
|
|
import com.sun.star.lib.uno.helper.Factory;
|
|
import com.sun.star.lang.XMultiComponentFactory;
|
|
import com.sun.star.lang.XSingleComponentFactory;
|
|
import com.sun.star.lib.uno.helper.WeakBase;
|
|
import com.sun.star.uno.UnoRuntime;
|
|
import com.sun.star.uno.XComponentContext;
|
|
import com.sun.star.registry.XRegistryKey;
|
|
import com.sun.star.lang.XInitialization;
|
|
import com.sun.star.lang.XTypeProvider;
|
|
import com.sun.star.lang.XServiceInfo;
|
|
import com.sun.star.uno.Type;
|
|
|
|
/** This class capsulates the class, that implements the minimal component, a
|
|
* factory for creating the service (<CODE>__getComponentFactory</CODE>) and a
|
|
* method, that writes the information into the given registry key
|
|
* (<CODE>__writeRegistryServiceInfo</CODE>).
|
|
*/
|
|
public class MinimalComponent {
|
|
/** This class implements the component. At least the interfaces XServiceInfo,
|
|
* XTypeProvider, and XInitialization should be provided by the service.
|
|
*/
|
|
public static class _MinimalComponent extends WeakBase
|
|
implements XInitialization, XServiceInfo {
|
|
/** The service name, that must be used to get an instance of this service.
|
|
*/
|
|
static private final String __serviceName =
|
|
"org.openoffice.MinimalComponent";
|
|
|
|
/** The initial component contextr, that gives access to
|
|
* the service manager, supported singletons, ...
|
|
* It's often later used
|
|
*/
|
|
private XComponentContext m_cmpCtx;
|
|
|
|
/** The service manager, that gives access to all registered services.
|
|
* It's often later used
|
|
*/
|
|
private XMultiComponentFactory m_xMCF;
|
|
|
|
/** The constructor of the inner class has a XMultiServiceFactory parameter.
|
|
* @param xmultiservicefactoryInitialization A special service factory
|
|
* could be introduced while initializing.
|
|
*/
|
|
public _MinimalComponent(XComponentContext xCompContext) {
|
|
try {
|
|
m_cmpCtx = xCompContext;
|
|
m_xMCF = m_cmpCtx.getServiceManager();
|
|
}
|
|
catch( Exception e ) {
|
|
e.printStackTrace();
|
|
}
|
|
}
|
|
|
|
/** This method is a member of the interface for initializing an object
|
|
* directly after its creation.
|
|
* @param object This array of arbitrary objects will be passed to the
|
|
* component after its creation.
|
|
* @throws Exception Every exception will not be handled, but will be
|
|
* passed to the caller.
|
|
*/
|
|
public void initialize( Object[] object )
|
|
throws com.sun.star.uno.Exception {
|
|
/* The component describes what arguments its expected and in which
|
|
* order!At this point you can read the objects and can intialize
|
|
* your component using these objects.
|
|
*/
|
|
}
|
|
|
|
/** This method returns an array of all supported service names.
|
|
* @return Array of supported service names.
|
|
*/
|
|
public String[] getSupportedServiceNames() {
|
|
return getServiceNames();
|
|
}
|
|
|
|
/** This method is a simple helper function to used in the
|
|
* static component initialisation functions as well as in
|
|
* getSupportedServiceNames.
|
|
*/
|
|
public static String[] getServiceNames() {
|
|
String[] sSupportedServiceNames = { __serviceName };
|
|
return sSupportedServiceNames;
|
|
}
|
|
|
|
/** This method returns true, if the given service will be
|
|
* supported by the component.
|
|
* @param sServiceName Service name.
|
|
* @return True, if the given service name will be supported.
|
|
*/
|
|
public boolean supportsService( String sServiceName ) {
|
|
return sServiceName.equals( __serviceName );
|
|
}
|
|
|
|
/** Return the class name of the component.
|
|
* @return Class name of the component.
|
|
*/
|
|
public String getImplementationName() {
|
|
return _MinimalComponent.class.getName();
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* Gives a factory for creating the service.
|
|
* This method is called by the <code>JavaLoader</code>
|
|
* <p>
|
|
* @return returns a <code>XSingleComponentFactory</code> for creating
|
|
* the component
|
|
* @param sImplName the name of the implementation for which a
|
|
* service is desired
|
|
* @see com.sun.star.comp.loader.JavaLoader
|
|
*/
|
|
public static XSingleComponentFactory __getComponentFactory(String sImplName)
|
|
{
|
|
XSingleComponentFactory xFactory = null;
|
|
|
|
if ( sImplName.equals( _MinimalComponent.class.getName() ) )
|
|
xFactory = Factory.createComponentFactory(_MinimalComponent.class,
|
|
_MinimalComponent.getServiceNames());
|
|
|
|
return xFactory;
|
|
}
|
|
|
|
/**
|
|
* Writes the service information into the given registry key.
|
|
* This method is called by the <code>JavaLoader</code>
|
|
* <p>
|
|
* @return returns true if the operation succeeded
|
|
* @param regKey the registryKey
|
|
* @see com.sun.star.comp.loader.JavaLoader
|
|
*/
|
|
// This method not longer necessary since OOo 3.4 where the component registration
|
|
// was changed to passive component registration. For more details see
|
|
// http://wiki.services.openoffice.org/wiki/Passive_Component_Registration
|
|
|
|
// public static boolean __writeRegistryServiceInfo(XRegistryKey regKey) {
|
|
// return Factory.writeRegistryServiceInfo(_MinimalComponent.class.getName(),
|
|
// _MinimalComponent.getServiceNames(),
|
|
// regKey);
|
|
// }
|
|
}
|