Samuel Mehrbrodt
35518c9236
This moves the classes from juh.jar and ridl.jar to libreoffice.jar
The goal is to have one single jar (and Java module, will be added later)
which developers can include to work with LO.
juh.jar and ridl.jar are kept as basically empty jars with libreoffice.jar
on its classpath to keep backwards compatibility.
This is a continuation of ae855bf481
and a preparation to have Java 9 module support.
Change-Id: Ifbbfb97f60373d14256e62ae3122913bd17d5bbb
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/91930
Tested-by: Jenkins
Reviewed-by: Stephan Bergmann <sbergman@redhat.com>
1104 lines
53 KiB
Java
1104 lines
53 KiB
Java
/*
|
|
* This file is part of the LibreOffice project.
|
|
*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*
|
|
* This file incorporates work covered by the following license notice:
|
|
*
|
|
* 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 .
|
|
*/
|
|
package com.sun.star.lib.uno.helper;
|
|
|
|
import com.sun.star.uno.Type;
|
|
import com.sun.star.lang.EventObject;
|
|
import com.sun.star.lang.WrappedTargetException;
|
|
import com.sun.star.uno.TypeClass;
|
|
import com.sun.star.uno.AnyConverter;
|
|
import com.sun.star.uno.XInterface;
|
|
import com.sun.star.uno.Any;
|
|
import com.sun.star.uno.UnoRuntime;
|
|
import com.sun.star.beans.XPropertyChangeListener;
|
|
import com.sun.star.beans.XVetoableChangeListener;
|
|
import com.sun.star.beans.PropertyChangeEvent;
|
|
import com.sun.star.beans.XPropertySet;
|
|
import com.sun.star.beans.Property;
|
|
import com.sun.star.beans.PropertyAttribute;
|
|
import com.sun.star.beans.UnknownPropertyException;
|
|
import com.sun.star.beans.XPropertiesChangeListener;
|
|
import com.sun.star.beans.XPropertySetInfo;
|
|
import com.sun.star.beans.XFastPropertySet;
|
|
import com.sun.star.beans.PropertyVetoException;
|
|
import com.sun.star.beans.XMultiPropertySet;
|
|
import java.util.Iterator;
|
|
import java.util.Collection;
|
|
import java.util.HashMap;
|
|
import java.lang.reflect.Field;
|
|
import com.sun.star.lang.DisposedException;
|
|
|
|
|
|
/** This class is an implementation of the interfaces com.sun.star.beans.XPropertySet,
|
|
* com.sun.star.beans.XFastPropertySet and com.sun.star.beans.XMultiPropertySet. This
|
|
* class has to be inherited to be used. The values of properties are stored in member
|
|
* variables of the inheriting class. By overriding the methods
|
|
* {@link #convertPropertyValue convertPropertyValue},
|
|
* {@link #setPropertyValueNoBroadcast setPropertyValueNoBroadcast} and
|
|
* {@link #getPropertyValue(Property)} one can determine how
|
|
* property values are stored.
|
|
* When using the supplied implementations of this class then the member variables which
|
|
* hold property values have to be declared in the class which inherits last in the inheriting
|
|
* chain and they have to be public<p>
|
|
* Properties have to be registered by one of the registerProperty methods. They take among other
|
|
* arguments an Object named <em>id</em> which has to be a String that represents the name of
|
|
* the member variable. The registering has to occur in the constructor of the inheriting class.
|
|
* It is no allowed to add or change properties later on.<p>
|
|
* Example:
|
|
* <pre>
|
|
* public class Foo extends PropertySet
|
|
* {
|
|
* protected int intProp;
|
|
*
|
|
* public Foo()
|
|
* {
|
|
* registerProperty("PropertyA", 0, new Type(int.class), (short)0, "intProp");
|
|
* }
|
|
* }
|
|
*
|
|
* </pre>
|
|
*/
|
|
public class PropertySet extends ComponentBase implements XPropertySet, XFastPropertySet,
|
|
XMultiPropertySet
|
|
{
|
|
private HashMap<String,Property> _nameToPropertyMap;
|
|
private HashMap<Integer,Property> _handleToPropertyMap;
|
|
private HashMap<Property,Object> _propertyToIdMap;
|
|
private Property[] arProperties;
|
|
|
|
private int lastHandle= 1;
|
|
|
|
protected XPropertySetInfo propertySetInfo;
|
|
protected MultiTypeInterfaceContainer aBoundLC= new MultiTypeInterfaceContainer();
|
|
protected MultiTypeInterfaceContainer aVetoableLC= new MultiTypeInterfaceContainer();
|
|
public PropertySet()
|
|
{
|
|
super();
|
|
initMappings();
|
|
}
|
|
|
|
/** Registers a property with this helper class and associates the argument <em>id</em> with it.
|
|
* <em>id</em> is used to identify the storage of the property value. How property values are stored
|
|
* and retrieved is determined by the methods {@link #convertPropertyValue convertPropertyValue},
|
|
* {@link #setPropertyValueNoBroadcast setPropertyValueNoBroadcast} and {@link #getPropertyValue(Property) getPropertyValue}
|
|
* These methods expect <em>id</em> to be a String which represents the name of a member variable
|
|
* which holds the property value.
|
|
* Only properties which are registered can be accessed. Registration has to occur during
|
|
* initialization of the inheriting class (i.e. within the constructor).
|
|
* @param prop The property to be registered.
|
|
* @param id Identifies the properties storage.
|
|
* @see #getPropertyId
|
|
*/
|
|
protected void registerProperty(Property prop, Object id)
|
|
{
|
|
putProperty(prop);
|
|
assignPropertyId(prop, id);
|
|
}
|
|
|
|
/** Registers a property with this helper class and associates the argument id with it.
|
|
* It does the same as {@link #registerProperty(Property, Object)}. The first four
|
|
* arguments are used to construct a Property object.
|
|
* Registration has to occur during
|
|
* initialization of the inheriting class (i.e. within the constructor)
|
|
* @param name The property's name (Property.Name).
|
|
* @param handle The property's handle (Property.Handle).
|
|
* @param type The property's type (Property.Type).
|
|
* @param attributes The property's attributes (Property.Attributes).
|
|
* @param id Identifies the property's storage.
|
|
*/
|
|
protected void registerProperty(String name, int handle, Type type, short attributes, Object id)
|
|
{
|
|
Property p= new Property(name, handle, type, attributes);
|
|
registerProperty(p, id);
|
|
}
|
|
|
|
/** Registers a property with this class and associates the argument id with it.
|
|
* It does the same as {@link #registerProperty(Property, Object)}. The first three
|
|
* arguments are used to construct a Property object. The value for the Property.Handle
|
|
* is generated and does not have to be specified here. Use this method for registering
|
|
* a property if you do not care about the Property's handles.
|
|
* Registration has to occur during
|
|
* initialization of the inheriting class (i.e. within the constructor).
|
|
* @param name The property's name (Property.Name).
|
|
* @param type The property's type (Property.Type).
|
|
* @param attributes The property's attributes (Property.Attributes).
|
|
* @param id Identifies the property's storage.
|
|
*/
|
|
protected void registerProperty(String name, Type type, short attributes, Object id)
|
|
{
|
|
Property p= new Property(name, lastHandle++, type, attributes);
|
|
registerProperty(p, id);
|
|
}
|
|
|
|
/** Registers a property with this class. This method expects that property values
|
|
* are stored in member variables as is the case if the methods convertPropertyValue,
|
|
* setPropertyValueNoBroadcast and getPropertyValue(Property) are not overridden.
|
|
* It is presumed that the type of the member variable
|
|
* corresponds Property.Type. For example, if the TypeClass of Property.Type is to be
|
|
* a TypeClass.SHORT then the member must be a short or java.lang.Short.
|
|
* The handle for the property is generated.<br>
|
|
* If there is no member with the specified name or if the member has an incompatible type
|
|
* then a com.sun.star.uno.RuntimeException is thrown.
|
|
* @param propertyName The name of the property.
|
|
* @param memberName The name of the member variable that holds the value of the property.
|
|
* @param attributes The property attributes.
|
|
*/
|
|
protected void registerProperty(String propertyName, String memberName, short attributes)
|
|
{
|
|
Field propField= null;
|
|
try
|
|
{
|
|
propField= getClass().getDeclaredField(memberName);
|
|
}
|
|
catch (NoSuchFieldException e)
|
|
{
|
|
throw new com.sun.star.uno.RuntimeException(e, "there is no member variable: " + memberName);
|
|
}
|
|
Class cl= propField.getType();
|
|
Type t= new Type(cl);
|
|
if (t.getTypeClass() != TypeClass.UNKNOWN)
|
|
{
|
|
Property p= new Property(propertyName, lastHandle++, t, attributes);
|
|
registerProperty(p,memberName);
|
|
}
|
|
else
|
|
throw new com.sun.star.uno.RuntimeException("the member has an unknown type: " + memberName);
|
|
}
|
|
|
|
/** Registers a property with this class.
|
|
* It is presumed that the name of property is equal to the name of the member variable
|
|
* that holds the property value.
|
|
* @param propertyName The name of the property and the member variable that holds the property's value.
|
|
* @param attributes The property attributes.
|
|
* @see #registerProperty(String, String, short)
|
|
*/
|
|
protected void registerProperty(String propertyName, short attributes)
|
|
{
|
|
registerProperty(propertyName, propertyName, attributes);
|
|
}
|
|
|
|
|
|
|
|
/** Returns the Property object for a given property name or null if that property does
|
|
* not exists (i.e. it has not been registered). Override this method
|
|
* if you want to implement your own mapping from property names to Property objects.
|
|
* Then you also have to override {@link #initMappings}, {@link #getProperties()} and
|
|
* {@link #putProperty(Property)}.
|
|
* @param propertyName The name of the property (Property.Name)
|
|
* @return The Property object with the name <em>propertyName</em>.
|
|
*/
|
|
protected Property getProperty(String propertyName)
|
|
{
|
|
return _nameToPropertyMap.get(propertyName);
|
|
}
|
|
|
|
/** Returns the Property object with a handle (Property.Handle) as specified by the argument
|
|
* <em>nHandle</em>. The method returns null if there is no such property (i.e. it has not
|
|
* been registered). Override this method if you want to implement your own mapping from handles
|
|
* to Property objects. Then you also have to override {@link #initMappings}, {@link #putProperty(Property)}.
|
|
* @param nHandle The handle of the property (Property.Handle).
|
|
* @return The Property object with the handle <em>nHandle</em>
|
|
*/
|
|
protected Property getPropertyByHandle(int nHandle)
|
|
{
|
|
return _handleToPropertyMap.get(Integer.valueOf(nHandle));
|
|
}
|
|
|
|
/** Returns an array of all Property objects or an array of length null if there
|
|
* are no properties. Override this method if you want to implement your own mapping from names
|
|
* to Property objects. Then you also have to override {@link #initMappings}, {@link #getProperty(String)} and
|
|
* {@link #putProperty}.
|
|
* @return Array of all Property objects.
|
|
*/
|
|
protected Property[] getProperties()
|
|
{
|
|
if (arProperties == null)
|
|
{
|
|
Collection<Property> values= _nameToPropertyMap.values();
|
|
arProperties= values.toArray(new Property[_nameToPropertyMap.size()]);
|
|
}
|
|
return arProperties;
|
|
}
|
|
|
|
/** Stores a Property object so that it can be retrieved subsequently by
|
|
* {@link #getProperty(String)},{@link #getProperties()},{@link #getPropertyByHandle(int)}.
|
|
* Override this method if you want to implement your own mapping from handles
|
|
* to Property objects and names to Property objects. Then you also need to override {@link #initMappings},
|
|
* {@link #getProperty(String)},{@link #getProperties()},{@link #getPropertyByHandle(int)}.
|
|
* @param prop The Property object that is to be stored.
|
|
*/
|
|
protected void putProperty(Property prop)
|
|
{
|
|
_nameToPropertyMap.put(prop.Name, prop);
|
|
if (prop.Handle != -1)
|
|
_handleToPropertyMap.put(Integer.valueOf(prop.Handle), prop);
|
|
}
|
|
|
|
/** Assigns an identifier object to a Property object so that the identifier
|
|
* can be obtained by {@link #getPropertyId getPropertyId} later on. The identifier
|
|
* is used to specify a certain storage for the property's value. If you do not
|
|
* override {@link #setPropertyValueNoBroadcast setPropertyValueNoBroadcast} or {@link #getPropertyValue(Property)}
|
|
* then the argument <em>id</em> has to be a String that equals the name of
|
|
* the member variable that holds the Property's value.
|
|
* Override this method if you want to implement your own mapping from Property objects to ids or
|
|
* if you need ids of a type other than String.
|
|
* Then you also need to override {@link #initMappings initMappings} and {@link #getPropertyId getPropertyId}.
|
|
* @param prop The Property object that is being assigned an id.
|
|
* @param id The object which identifies the storage used for the property's value.
|
|
* @see #registerProperty(Property, Object)
|
|
*/
|
|
protected void assignPropertyId(Property prop, Object id)
|
|
{
|
|
if (id instanceof String && ((String) id).length() != 0)
|
|
_propertyToIdMap.put(prop, id);
|
|
}
|
|
|
|
/** Returns the identifier object for a certain Property. The object must have been
|
|
* previously assigned to the Property object by {@link #assignPropertyId assignPropertyId}.
|
|
* Override this method if you want to implement your own mapping from Property objects to ids.
|
|
* Then you also need to override {@link #initMappings initMappings} and {@link #assignPropertyId assignPropertyId}.
|
|
* @param prop The property for which the id is to be retrieved.
|
|
* @return The id object that identifies the storage used for the property's value.
|
|
* @see #registerProperty(Property, Object)
|
|
*/
|
|
protected Object getPropertyId(Property prop)
|
|
{
|
|
return _propertyToIdMap.get(prop);
|
|
}
|
|
|
|
/** Initializes data structures used for mappings of property names to property object,
|
|
* property handles to property objects and property objects to id objects.
|
|
* Override this method if you want to implement your own mappings. Then you also need to
|
|
* override {@link #putProperty putProperty},{@link #getProperty getProperty}, {@link #getPropertyByHandle},
|
|
* {@link #assignPropertyId assignPropertyId} and {@link #getPropertyId getPropertyId}.
|
|
*/
|
|
protected void initMappings()
|
|
{
|
|
_nameToPropertyMap= new HashMap<String,Property>();
|
|
_handleToPropertyMap= new HashMap<Integer,Property>();
|
|
_propertyToIdMap= new HashMap<Property,Object>();
|
|
}
|
|
|
|
/** Makes sure that listeners which are kept in aBoundLC (XPropertyChangeListener) and aVetoableLC
|
|
* (XVetoableChangeListener) receive a disposing call. Also those listeners are released.
|
|
*/
|
|
@Override
|
|
protected void postDisposing()
|
|
{
|
|
// Create an event with this as sender
|
|
EventObject aEvt= new EventObject(this);
|
|
|
|
// inform all listeners to release this object
|
|
aBoundLC.disposeAndClear(aEvt);
|
|
aVetoableLC.disposeAndClear(aEvt);
|
|
}
|
|
|
|
//XPropertySet ----------------------------------------------------
|
|
synchronized public void addPropertyChangeListener(String str, XPropertyChangeListener xPropertyChangeListener)
|
|
throws UnknownPropertyException, WrappedTargetException
|
|
{
|
|
// only add listeners if you are not disposed
|
|
if (! bInDispose && ! bDisposed)
|
|
{
|
|
if (str.length() > 0)
|
|
{
|
|
Property prop= getProperty(str);
|
|
if (prop == null)
|
|
throw new UnknownPropertyException("Property " + str + " is unknown");
|
|
|
|
// Add listener for a certain property
|
|
if ((prop.Attributes & PropertyAttribute.BOUND) > 0)
|
|
aBoundLC.addInterface(str, xPropertyChangeListener);
|
|
else
|
|
//ignore silently
|
|
return;
|
|
}
|
|
else
|
|
// Add listener for all properties
|
|
listenerContainer.addInterface(XPropertyChangeListener.class, xPropertyChangeListener);
|
|
}
|
|
}
|
|
//XPropertySet ----------------------------------------------------
|
|
synchronized public void addVetoableChangeListener(String str, com.sun.star.beans.XVetoableChangeListener xVetoableChangeListener) throws com.sun.star.beans.UnknownPropertyException, com.sun.star.lang.WrappedTargetException
|
|
{
|
|
// only add listeners if you are not disposed
|
|
if (! bInDispose && ! bDisposed)
|
|
{
|
|
if (str.length() > 0)
|
|
{
|
|
Property prop= getProperty(str);
|
|
if (prop == null)
|
|
throw new UnknownPropertyException("Property " + str + " is unknown");
|
|
|
|
// Add listener for a certain property
|
|
if ((prop.Attributes & PropertyAttribute.CONSTRAINED) > 0)
|
|
aVetoableLC.addInterface(str, xVetoableChangeListener);
|
|
else
|
|
//ignore silently
|
|
return;
|
|
}
|
|
else
|
|
// Add listener for all properties
|
|
listenerContainer.addInterface(XVetoableChangeListener.class, xVetoableChangeListener);
|
|
}
|
|
}
|
|
//XPropertySet ----------------------------------------------------
|
|
public synchronized com.sun.star.beans.XPropertySetInfo getPropertySetInfo()
|
|
{
|
|
if (propertySetInfo == null)
|
|
propertySetInfo= new PropertySetInfo();
|
|
return propertySetInfo;
|
|
}
|
|
//XPropertySet ----------------------------------------------------
|
|
public Object getPropertyValue(String name) throws UnknownPropertyException, WrappedTargetException
|
|
{
|
|
Object ret= null;
|
|
if (bInDispose || bDisposed)
|
|
throw new com.sun.star.lang.DisposedException("The component has been disposed already");
|
|
|
|
Property prop= getProperty(name);
|
|
if (prop == null)
|
|
throw new UnknownPropertyException("The property " + name + " is unknown");
|
|
|
|
synchronized (this)
|
|
{
|
|
ret= getPropertyValue(prop);
|
|
}
|
|
// null must not be returned. Either a void any is returned or an any containing
|
|
// an interface type and a null reference.
|
|
if (ret == null)
|
|
{
|
|
if (prop.Type.getTypeClass() == TypeClass.INTERFACE)
|
|
ret= new Any(prop.Type, null);
|
|
else
|
|
ret= new Any(new Type(void.class), null);
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
//XPropertySet ----------------------------------------------------
|
|
synchronized public void removePropertyChangeListener(String propName, XPropertyChangeListener listener) throws UnknownPropertyException, WrappedTargetException
|
|
{ // all listeners are automatically released in a dispose call
|
|
if (!bInDispose && !bDisposed)
|
|
{
|
|
if (propName.length() > 0)
|
|
{
|
|
Property prop = getProperty(propName);
|
|
if (prop == null)
|
|
throw new UnknownPropertyException("Property " + propName + " is unknown");
|
|
aBoundLC.removeInterface(propName, listener);
|
|
}
|
|
else
|
|
listenerContainer.removeInterface(XPropertyChangeListener.class, listener);
|
|
}
|
|
}
|
|
|
|
//XPropertySet ----------------------------------------------------
|
|
synchronized public void removeVetoableChangeListener(String propName, XVetoableChangeListener listener) throws UnknownPropertyException, WrappedTargetException
|
|
{// all listeners are automatically released in a dispose call
|
|
if (!bInDispose && !bDisposed)
|
|
{
|
|
if (propName.length() > 0)
|
|
{
|
|
Property prop = getProperty(propName);
|
|
if (prop == null)
|
|
throw new UnknownPropertyException("Property " + propName + " is unknown");
|
|
aVetoableLC.removeInterface(propName, listener);
|
|
}
|
|
else
|
|
listenerContainer.removeInterface(XVetoableChangeListener.class, listener);
|
|
}
|
|
}
|
|
|
|
//XPropertySet ----------------------------------------------------
|
|
/** Sets the value of a property.
|
|
* The idl description for this interfaces, stipulates that the argument value is an Any. Since a java.lang.Object
|
|
* reference has the same meaning as an Any this function accepts
|
|
* java anys (com.sun.star.uno.Any) and all other appropriate objects as arguments. The value argument can be one
|
|
* of these:
|
|
* <ul>
|
|
* <li>java.lang.Boolean</li>
|
|
* <li>java.lang.Character</li>
|
|
* <li>java.lang.Byte</li>
|
|
* <li>java.lang.Short</li>
|
|
* <li>java.lang.Integer</li>
|
|
* <li>java.lang.Long</li>
|
|
* <li>java.lang.Float</li>
|
|
* <li>java.lang.Double</li>
|
|
* <li>String</li>
|
|
* <li>com.sun.star.uno.Type</li>
|
|
* <li><em>objects which implement UNO interfaces</em></li>
|
|
* <li><em>arrays which contain elements of the types above</em></li>
|
|
* <li>com.sun.star.uno.Any containing an instance of one of the above types</li>
|
|
* </ul>
|
|
*
|
|
* Properties can have the attribute com.sun.star.beans.PropertyAttribute.MAYBEVOID, which means that the value
|
|
* (not the type) can be void. In order to assign a void value to a property one can either pass an Any which
|
|
* contains a null reference or pass null directly. In both cases the null reference is only accepted if
|
|
* the PropertyAttribute.MAYBEVOID attribute is set for the property.
|
|
*
|
|
* Properties which have the attribute MAYBEVOID set (Property.Attributes) can have a void value. The following
|
|
* considerations presume that the Property has that attribute set. Further, when mentioning an Any's value we
|
|
* actually refer to the object returned by Any.getObject.
|
|
* If the argument <em>value</em> is null, or it is an Any whose value is null (but with a valid Type)
|
|
* then the member variable used for storing the property's value is set to null.
|
|
* Therefore those properties can only be stored in objects
|
|
* and primitive types are not allowed (one can use the wrapper classes instead,e.g. java.lang.Byte) .
|
|
* If a property's value is kept in a member variable of type Any and that reference is still null
|
|
* then when setPropertyValue is called with
|
|
* <em>value</em> = null then the member variable is assigned an Any with type void and a null value.
|
|
* Or if the argument is an Any with a null value then it is assigned to the member variable.
|
|
* Further, if the variable already
|
|
* references an Any and setPropertyValue is called with <em>value</em> = null, then the variable is assigned
|
|
* a new Any with the same type as the previously referenced Any and with a null value.
|
|
* @param name The name of the property.
|
|
* @param value The new value of the property.
|
|
* * */
|
|
public void setPropertyValue(String name, Object value) throws UnknownPropertyException,
|
|
PropertyVetoException, com.sun.star.lang.IllegalArgumentException, WrappedTargetException
|
|
{
|
|
Property prop= getProperty(name);
|
|
if (prop == null)
|
|
throw new UnknownPropertyException("Property " + name + " is unknown");
|
|
setPropertyValue(prop, value);
|
|
}
|
|
|
|
/** Sets the value of a property. It checks if the property's attributes (READONLY,MAYBEVOID), allow that the
|
|
* new value can be set. It also causes the notification of listeners.
|
|
* @param prop The property whose value is to be set.
|
|
* @param value The new value for the property.
|
|
*
|
|
* @throws UnknownPropertyException
|
|
* See com.sun.star.beans.XPropertySet
|
|
* @throws PropertyVetoException
|
|
* See com.sun.star.beans.XPropertySet
|
|
* @throws WrappedTargetException
|
|
* See com.sun.star.beans.XPropertySet
|
|
*/
|
|
protected void setPropertyValue(Property prop, Object value) throws UnknownPropertyException,
|
|
PropertyVetoException, com.sun.star.lang.IllegalArgumentException, WrappedTargetException
|
|
{
|
|
if ((prop.Attributes & PropertyAttribute.READONLY) == PropertyAttribute.READONLY)
|
|
throw new com.sun.star.beans.PropertyVetoException();
|
|
// The value may be null only if MAYBEVOID attribute is set
|
|
boolean bVoidValue;
|
|
if (value instanceof Any)
|
|
bVoidValue= ((Any) value).getObject() == null;
|
|
else
|
|
bVoidValue= value == null;
|
|
if (bVoidValue && (prop.Attributes & PropertyAttribute.MAYBEVOID) == 0)
|
|
throw new com.sun.star.lang.IllegalArgumentException("The property must have a value; the MAYBEVOID attribute is not set!");
|
|
if (bInDispose || bDisposed)
|
|
throw new DisposedException("Component is already disposed");
|
|
|
|
//Check if the argument is allowed
|
|
boolean bValueOk;
|
|
if (value instanceof Any)
|
|
bValueOk= checkType(((Any) value).getObject());
|
|
else
|
|
bValueOk= checkType(value);
|
|
if (! bValueOk)
|
|
throw new com.sun.star.lang.IllegalArgumentException("No valid UNO type");
|
|
|
|
|
|
boolean bConversionOk= false;
|
|
Object[] outConvertedVal= new Object[1];
|
|
Object[] outOldValue= new Object[1];
|
|
synchronized (this)
|
|
{
|
|
bConversionOk= convertPropertyValue(prop, outConvertedVal, outOldValue, value);
|
|
}
|
|
|
|
//The next step following the conversion is to set the new value of the property. Prior to this
|
|
// the XVetoableChangeListener s have to be notified.
|
|
if (bConversionOk)
|
|
{
|
|
// If the property is CONSTRAINED, then we must notify XVetoableChangeListener. The listener can throw a com.sun.star.lang.beans.PropertyVetoException which
|
|
// will cause this method to return (the exception is not caught here).
|
|
fire( new Property[]{prop}, outConvertedVal, outOldValue, true);
|
|
|
|
synchronized (this)
|
|
{
|
|
setPropertyValueNoBroadcast(prop, outConvertedVal[0]);
|
|
}
|
|
// fire a change event (XPropertyChangeListener, PropertyAttribute.BOUND
|
|
fire( new Property[]{prop}, outConvertedVal, outOldValue, false);
|
|
}
|
|
}
|
|
|
|
/** Converts a value in a way so that it is appropriate for storing as a property value, that is
|
|
* {@link #setPropertyValueNoBroadcast setPropertyValueNoBroadcast} can process the value without any further
|
|
* conversion. This implementation presumes that
|
|
* the values are stored in member variables of the furthest inheriting class. For example,
|
|
* class A inherits this class then members of class A
|
|
* can hold property values. If there is a class B which inherits A then only members of B can hold
|
|
* property values. The variables must be public. A property must have been registered (e.g. by
|
|
* {@link #registerProperty(Property, Object)} in order for this method to work. The identifier argument (type Object)
|
|
* used in the registerProperty methods must
|
|
* be a String, which is, the name of the member variable that holds the property value.
|
|
* If one opts to store values differently then one may override
|
|
* this method, as well as {@link #setPropertyValueNoBroadcast setPropertyValueNoBroadcast} and
|
|
* {@link #getPropertyValue(Property) getPropertyValue(Property)}.
|
|
* This method is always called as a result of a call to one of the setter methods, such as
|
|
* {@link #setPropertyValue(String,Object) XPropertySet.setPropertyValue},
|
|
* {@link #setFastPropertyValue XFastPropertySet.setFastPropertyValue}
|
|
* and {@link #setPropertyValues XMultiPropertySet.setPropertyValues}.
|
|
* If this method fails, that is, it returns false or throws an exception, then no listeners are notified and the
|
|
* property value, that was intended to be changed, remains untouched.
|
|
*
|
|
* This method does not have to deal with property attributes, such as
|
|
* PropertyAttribute.READONLY or PropertyAttribute.MAYBEVOID. The processing of these attributes occurs
|
|
* in the calling methods.
|
|
*
|
|
* Only if this method returns successfully further processing, such
|
|
* as listener notification and finally the modification of the property's value, will occur.
|
|
*
|
|
* The actual modification of a property's value is done by {@link #setPropertyValueNoBroadcast setPropertyValueNoBroadcast}
|
|
* which is called subsequent to convertPropertyValue.
|
|
*<p>
|
|
* This method converts values by help of the com.sun.star.uno.AnyConverter which only does a few widening
|
|
* conversions on integer types and floating point types. For example, there is the property PropA with a Type equivalent
|
|
* to int.class and the
|
|
* value of the property is to be stored in a member variable of type int with name intProp. Then setPropertyValue is
|
|
* called:
|
|
* <pre>
|
|
* set.setPropertyValue( "PropA", Byte.valueOf( (byte)111));
|
|
* </pre>
|
|
* At some point setPropertyValue will call convertPropertyValue and pass in the Byte object. Since we allow
|
|
* that Byte values can be used with the property and know that the value is to be stored in intProp (type int)
|
|
* we convert the Byte object into an Integer object which is then returned in the out-parameter <em>newVal</em>. This
|
|
* conversion is actually performed by the AnyConverter. Later
|
|
* the setPropertyValueNoBroadcast is called with that Integer object and the int value can be easily extracted
|
|
* from the object and be assigned to the member intProp.
|
|
* <p>
|
|
* The method handles Any arguments the same as Object arguments. That is, the <em>setVal</em> argument can
|
|
* be a java.lang.Boolean or a com.sun.star.uno.Any containing a java.lang.Boolean. Likewise, a member
|
|
* containing a property value can be a com.sun.star.uno.Any or a java.lang.Object.
|
|
* Then, no conversion is necessary, since they can hold all possible values. However, if
|
|
* the member is an Object and <em>setVal</em> is an Any then the object contained in the any is assigned to
|
|
* the member. The extra type information which exists as Type object in the Any will get lost. If this is not
|
|
* intended then use an Any variable rather than an Object.
|
|
*
|
|
* If a member is an Object or Any and the argument <em>setVal</em> is an Object, other than String or array,
|
|
* then it is presumed to be a UNO object and queried for XInterface. If successful, the out-param <em>newVal</em>
|
|
* returns the XInterface.
|
|
*
|
|
* If a member is a UNO interface, then <em>setVal</em> is queried for this interface and the result is returned.
|
|
* If <em>setVal</em> is null then <em>newVal</em> will be null too after return.
|
|
* <p>
|
|
* If a property value is stored using a primitive type the out-parameters
|
|
* <em>curVal</em> and <em>newVal</em> contain the respective wrapper class (e.g.java.lang.Byte, etc.).
|
|
* curVal is used in calls to the XVetoableChangeListener and XPropertyChangeListener.
|
|
*
|
|
* @param property - in-param property for which the data is to be converted.
|
|
* @param newVal - out-param which contains the converted value on return.
|
|
* @param curVal - out-param the current value of the property. It is used in calls to the
|
|
* XVetoableChangeListener and XPropertyChangeListener.
|
|
* @param setVal - in-param. The value that is to be converted so that it matches Property and the internally used
|
|
* dataformat for that property.
|
|
* @return true - Conversion was successful. <em>newVal</em> contains a valid value for the property. false -
|
|
* conversion failed for some reason.
|
|
*
|
|
* @throws UnknownPropertyException
|
|
* See com.sun.star.beans.XPropertySet
|
|
* @throws com.sun.star.lang.IllegalArgumentException The value provided is unfit for the property.
|
|
* @throws com.sun.star.lang.WrappedTargetException - An exception occurred during the conversion, that is to be made known
|
|
* to the caller.
|
|
*/
|
|
protected boolean convertPropertyValue(Property property, Object[] newVal, Object[]curVal, Object setVal)
|
|
throws com.sun.star.lang.IllegalArgumentException, WrappedTargetException, UnknownPropertyException
|
|
{
|
|
boolean ret= true;
|
|
try
|
|
{
|
|
// get the member name
|
|
String sMember= (String) getPropertyId(property);
|
|
if (sMember != null)
|
|
{
|
|
// use reflection to obtain the field that holds the property value
|
|
// Class.getDeclaredFields does not return inherited fields. One could use Class.getFields to
|
|
// also get inherited fields, but only those which are public.
|
|
Field propField= getClass().getDeclaredField(sMember);
|
|
if (propField != null)
|
|
{
|
|
curVal[0]= propField.get(this);
|
|
Class memberClass= propField.getType();
|
|
|
|
// MAYBEVOID: if setVal == null or it is an Any and getObject returns null, then a void value is to be set
|
|
// This works only if there are no primitive types. For those we use the respective wrapper classes.
|
|
// In this implementation, a null reference means void value.
|
|
boolean bVoidValue= false;
|
|
boolean bAnyVal= setVal instanceof Any;
|
|
if (bAnyVal)
|
|
bVoidValue= ((Any) setVal).getObject() == null;
|
|
else
|
|
bVoidValue= setVal == null;
|
|
if (bVoidValue && memberClass.isPrimitive())
|
|
throw new com.sun.star.lang.IllegalArgumentException("The implementation does not support the MAYBEVOID attribute for this property");
|
|
|
|
Object convObj= null;
|
|
//The member that keeps the value of the Property is an Any. It can contain all possible
|
|
//types, therefore a conversion is not necessary.
|
|
if (memberClass.equals(Any.class))
|
|
{
|
|
if (bAnyVal)
|
|
//parameter setVal is also an Any and can be used without further processing
|
|
convObj= setVal;
|
|
else
|
|
{
|
|
// Parameter setVal is not an Any. We need to construct an Any that contains
|
|
// the argument setVal.
|
|
// If setVal is an interface implementation then, we cannot construct the
|
|
// Any with setVal.getClass(), because the Any.Type._typeClass would be TypeClass.UNKNOWN.
|
|
// We try to get an XInterface of setVal and set an XInterface type.
|
|
if (setVal instanceof XInterface)
|
|
{
|
|
XInterface xint= UnoRuntime.queryInterface(XInterface.class, setVal);
|
|
if (xint != null)
|
|
convObj= new Any(new Type(XInterface.class), xint);
|
|
}
|
|
// The member is an any, and the past in argument was null reference (MAYBEVOID is set)
|
|
else if (setVal == null)
|
|
{
|
|
// if the any member is still null we create a void any
|
|
if (curVal[0] == null)
|
|
convObj= new Any(new Type(), null);
|
|
else
|
|
{
|
|
//otherwise we create an Any with the same type as a value of null;
|
|
convObj= new Any( ((Any)curVal[0]).getType(), null);
|
|
}
|
|
}
|
|
else
|
|
convObj= new Any(new Type(setVal.getClass()), setVal);
|
|
}
|
|
}
|
|
else
|
|
convObj= convert(memberClass, setVal);
|
|
newVal[0]= convObj;
|
|
}
|
|
}
|
|
else
|
|
throw new UnknownPropertyException("Property " + property.Name + " is unknown");
|
|
}
|
|
catch (java.lang.NoSuchFieldException e)
|
|
{
|
|
throw new WrappedTargetException(e, "Field does not exist", this, e);
|
|
}
|
|
catch (java.lang.IllegalAccessException e)
|
|
{
|
|
throw new WrappedTargetException(e, "", this ,e);
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
private boolean checkType(Object obj)
|
|
{
|
|
return obj == null
|
|
|| obj instanceof Boolean
|
|
|| obj instanceof Character
|
|
|| obj instanceof Number
|
|
|| obj instanceof String
|
|
|| obj instanceof XInterface
|
|
|| obj instanceof Type
|
|
|| obj instanceof com.sun.star.uno.Enum
|
|
|| obj.getClass().isArray();
|
|
}
|
|
|
|
// Param object can be an Any or other object. If obj is null then the return value is null
|
|
private Object convert( Class cl, Object obj) throws com.sun.star.lang.IllegalArgumentException
|
|
{
|
|
Object retVal= null;
|
|
//The member that keeps the value of the Property is an Object.Objects are similar to Anys in that they can
|
|
// hold all types.
|
|
if (obj == null || (obj instanceof Any && ((Any) obj).getObject() == null))
|
|
{}
|
|
else if(cl.equals(Object.class))
|
|
{
|
|
if (obj instanceof Any)
|
|
obj= ((Any) obj).getObject();
|
|
retVal= obj;
|
|
}
|
|
else if(cl.equals(boolean.class))
|
|
retVal= Boolean.valueOf(AnyConverter.toBoolean(obj));
|
|
else if (cl.equals(char.class))
|
|
retVal= new Character(AnyConverter.toChar(obj));
|
|
else if (cl.equals(byte.class))
|
|
retVal= Byte.valueOf(AnyConverter.toByte(obj));
|
|
else if (cl.equals(short.class))
|
|
retVal= Short.valueOf(AnyConverter.toShort(obj));
|
|
else if (cl.equals(int.class))
|
|
retVal= Integer.valueOf(AnyConverter.toInt(obj));
|
|
else if (cl.equals(long.class))
|
|
retVal= Long.valueOf(AnyConverter.toLong(obj));
|
|
else if (cl.equals(float.class))
|
|
retVal= new Float(AnyConverter.toFloat(obj));
|
|
else if (cl.equals(double.class))
|
|
retVal= new Double(AnyConverter.toDouble(obj));
|
|
else if (cl.equals(String.class))
|
|
retVal= AnyConverter.toString(obj);
|
|
else if (cl.isArray())
|
|
retVal= AnyConverter.toArray(obj);
|
|
else if (cl.equals(Type.class))
|
|
retVal= AnyConverter.toType(obj);
|
|
else if (cl.equals(Boolean.class))
|
|
retVal= Boolean.valueOf(AnyConverter.toBoolean(obj));
|
|
else if (cl.equals(Character.class))
|
|
retVal= new Character(AnyConverter.toChar(obj));
|
|
else if (cl.equals(Byte.class))
|
|
retVal= Byte.valueOf(AnyConverter.toByte(obj));
|
|
else if (cl.equals(Short.class))
|
|
retVal= Short.valueOf(AnyConverter.toShort(obj));
|
|
else if (cl.equals(Integer.class))
|
|
retVal= Integer.valueOf(AnyConverter.toInt(obj));
|
|
else if (cl.equals(Long.class))
|
|
retVal= Long.valueOf(AnyConverter.toLong(obj));
|
|
else if (cl.equals(Float.class))
|
|
retVal= new Float(AnyConverter.toFloat(obj));
|
|
else if (cl.equals(Double.class))
|
|
retVal= new Double(AnyConverter.toDouble(obj));
|
|
else if (XInterface.class.isAssignableFrom(cl))
|
|
retVal= AnyConverter.toObject(new Type(cl), obj);
|
|
else if (com.sun.star.uno.Enum.class.isAssignableFrom(cl))
|
|
retVal= AnyConverter.toObject(new Type(cl), obj);
|
|
else
|
|
throw new com.sun.star.lang.IllegalArgumentException("Could not convert the argument");
|
|
return retVal;
|
|
}
|
|
|
|
/** Sets the value of a property. In this implementation property values are stored in member variables
|
|
* (see {@link #convertPropertyValue convertPropertyValue} Notification of property listeners
|
|
* does not occur in this method. By overriding this method one can take full control about how property values
|
|
* are stored. But then, the {@link #convertPropertyValue convertPropertyValue} and
|
|
* {@link #getPropertyValue(Property)} must be overridden too.
|
|
*
|
|
* A Property with the MAYBEVOID attribute set, is stored as null value. Therefore the member variable must be
|
|
* an Object in order to make use of the property attribute. An exception is Any. The Any variable can be initially null, but
|
|
* once it is set the reference will not become null again. If the value is to be set to
|
|
* void then a new Any will be stored
|
|
* with a valid type but without a value (i.e. Any.getObject returns null).
|
|
* If a property has the READONLY attribute set, and one of the setter methods, such as setPropertyValue, has been
|
|
* called, then this method is not going to be called.
|
|
* @param property the property for which the new value is set
|
|
* @param newVal the new value for the property.
|
|
* @throws com.sun.star.lang.WrappedTargetException An exception, which has to be made known to the caller,
|
|
* occurred during the setting of the value.
|
|
*/
|
|
protected void setPropertyValueNoBroadcast(Property property, Object newVal)
|
|
throws WrappedTargetException
|
|
{
|
|
try
|
|
{
|
|
// get the member name
|
|
String sMember= (String) getPropertyId(property);
|
|
if (sMember != null)
|
|
{
|
|
// use reflection to obtain the field that holds the property value
|
|
// Class.getDeclaredFields does not return inherited fields. One could use Class.getFields to
|
|
// also get inherited fields, but only those which are public.
|
|
Field propField= getClass().getDeclaredField(sMember);
|
|
if (propField != null)
|
|
propField.set(this, newVal);
|
|
}
|
|
}
|
|
catch(java.lang.Exception e)
|
|
{
|
|
throw new WrappedTargetException(e, "PropertySet.setPropertyValueNoBroadcast", this, e);
|
|
}
|
|
}
|
|
/** Retrieves the value of a property. This implementation presumes that the values are stored in member variables
|
|
* of the furthest inheriting class (see {@link #convertPropertyValue convertPropertyValue}) and that the
|
|
* variables are public. The property must have
|
|
* been registered, for example by {@link #registerProperty(Property, Object)}. The identifier Object argument
|
|
* must have been a String which was the name of the member variable holding the property value.
|
|
* When properties are to be stored differently one has to override this method as well as
|
|
* {@link #convertPropertyValue} and {@link #setPropertyValueNoBroadcast}. <br>
|
|
* If a value is stored in a variable of a primitive type then this method returns an instance of the respective
|
|
* wrapper class (e.g. java.lang.Boolean).
|
|
* @param property The property for which the value is to be retrieved.
|
|
* @return The value of the property.
|
|
*/
|
|
protected Object getPropertyValue(Property property)
|
|
{
|
|
Object ret= null;
|
|
try
|
|
{
|
|
// get the member name
|
|
String sMember= (String) getPropertyId(property);
|
|
if (sMember != null)
|
|
{
|
|
// use reflection to obtain the field that holds the property value
|
|
// Class.getDeclaredFields does not return inherited fields. One could use Class.getFields to
|
|
// also get inherited fields, but only those which are public.
|
|
Field propField= getClass().getDeclaredField(sMember);
|
|
if (propField != null)
|
|
ret= propField.get(this);
|
|
}
|
|
}
|
|
catch(java.lang.NoSuchFieldException e)
|
|
{
|
|
throw new java.lang.RuntimeException(e);
|
|
}
|
|
catch(java.lang.IllegalAccessException e)
|
|
{
|
|
throw new java.lang.RuntimeException(e);
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
/**
|
|
* This method fires events to XPropertyChangeListener,XVetoableChangeListener and
|
|
* XPropertiesChangeListener event sinks.
|
|
* To distinguish what listeners are to be called the argument <em>bVetoable</em> is to be set to true if
|
|
* a XVetoableChangeListener is meant. For XPropertyChangeListener and XPropertiesChangeListener
|
|
* it is to be set to false.
|
|
*
|
|
* @param properties Properties which will be or have been affected.
|
|
* @param newValues the new values of the properties.
|
|
* @param oldValues the old values of the properties.
|
|
* @param bVetoable true means fire to VetoableChangeListener, false means fire to
|
|
* XPropertyChangedListener and XMultiPropertyChangedListener.
|
|
*
|
|
* @throws PropertyVetoException
|
|
* if a vetoable listener throws it.
|
|
*/
|
|
protected void fire(
|
|
Property[] properties,
|
|
Object[] newValues,
|
|
Object[] oldValues,
|
|
boolean bVetoable ) throws PropertyVetoException
|
|
{
|
|
// Only fire, if one or more properties changed
|
|
int nNumProps= properties.length;
|
|
if (nNumProps > 0)
|
|
{
|
|
PropertyChangeEvent[] arEvts= new PropertyChangeEvent[nNumProps];
|
|
int nAffectedProps= 0;
|
|
// Loop over all changed properties to fill the event struct
|
|
for (int i= 0; i < nNumProps; i++)
|
|
{
|
|
if ((bVetoable && (properties[i].Attributes & PropertyAttribute.CONSTRAINED) > 0)
|
|
|| (!bVetoable && (properties[i].Attributes & PropertyAttribute.BOUND) > 0))
|
|
{
|
|
arEvts[i]= new PropertyChangeEvent(this, properties[i].Name, false,
|
|
properties[i].Handle, oldValues[i], newValues[i]);
|
|
nAffectedProps++;
|
|
}
|
|
}
|
|
// fire the events for all changed properties
|
|
for (int i= 0; i < nAffectedProps; i++)
|
|
{
|
|
// get the listener container for the property name
|
|
InterfaceContainer lc;
|
|
if (bVetoable)
|
|
lc= aVetoableLC.getContainer(arEvts[i].PropertyName);
|
|
else
|
|
lc= aBoundLC.getContainer(arEvts[i].PropertyName);
|
|
Iterator it = lc != null ? lc.iterator() : null;
|
|
if (it != null)
|
|
{
|
|
while( it.hasNext())
|
|
{
|
|
Object listener= it.next();
|
|
if (bVetoable)
|
|
((XVetoableChangeListener) listener).vetoableChange(arEvts[i]);
|
|
else
|
|
((XPropertyChangeListener) listener).propertyChange(arEvts[i]);
|
|
}
|
|
}
|
|
// broadcast to all listeners with "" property name
|
|
if(bVetoable)
|
|
lc= listenerContainer.getContainer(XVetoableChangeListener.class);
|
|
else
|
|
lc= listenerContainer.getContainer(XPropertyChangeListener.class);
|
|
it = lc != null ? lc.iterator() : null;
|
|
if (it != null)
|
|
{
|
|
while(it.hasNext() )
|
|
{
|
|
Object listener= it.next();
|
|
if( bVetoable ) // fire change Events?
|
|
((XVetoableChangeListener) listener).vetoableChange(arEvts[i]);
|
|
else
|
|
((XPropertyChangeListener) listener).propertyChange(arEvts[i]);
|
|
}
|
|
}
|
|
}
|
|
// fire at XPropertiesChangeListeners
|
|
// if nAffectedProps == 0 then there are no BOUND properties
|
|
if (!bVetoable && nAffectedProps > 0)
|
|
{
|
|
|
|
PropertyChangeEvent[] arReduced= new PropertyChangeEvent[nAffectedProps];
|
|
System.arraycopy(arEvts, 0, arReduced, 0, nAffectedProps);
|
|
InterfaceContainer lc= listenerContainer.getContainer(XPropertiesChangeListener.class);
|
|
Iterator it = lc != null ? lc.iterator() : null;
|
|
if (it != null)
|
|
{
|
|
while (it.hasNext())
|
|
{
|
|
XPropertiesChangeListener listener = (XPropertiesChangeListener) it.next();
|
|
// fire the whole event sequence to the XPropertiesChangeListener's
|
|
listener.propertiesChange( arEvts );
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
// XFastPropertySet--------------------------------------------------------------------------------
|
|
public void setFastPropertyValue(int nHandle, Object aValue ) throws UnknownPropertyException,
|
|
PropertyVetoException, com.sun.star.lang.IllegalArgumentException, WrappedTargetException
|
|
{
|
|
Property prop= getPropertyByHandle(nHandle);
|
|
if (prop == null)
|
|
throw new UnknownPropertyException(" The property with handle : " + nHandle +" is unknown");
|
|
setPropertyValue(prop, aValue);
|
|
}
|
|
|
|
// XFastPropertySet --------------------------------------------------------------------------------
|
|
public Object getFastPropertyValue(int nHandle ) throws UnknownPropertyException,
|
|
WrappedTargetException
|
|
{
|
|
Property prop= getPropertyByHandle(nHandle);
|
|
if (prop == null)
|
|
throw new UnknownPropertyException("The property with handle : " + nHandle + " is unknown");
|
|
return getPropertyValue(prop);
|
|
}
|
|
|
|
// XMultiPropertySet -----------------------------------------------------------------------------------
|
|
public void addPropertiesChangeListener(String[] propNames, XPropertiesChangeListener listener)
|
|
{
|
|
listenerContainer.addInterface(XPropertiesChangeListener.class, listener);
|
|
}
|
|
|
|
// XMultiPropertySet -----------------------------------------------------------------------------------
|
|
public void firePropertiesChangeEvent(String[] propNames, XPropertiesChangeListener listener)
|
|
{
|
|
// Build the events.
|
|
PropertyChangeEvent[] arEvents= new PropertyChangeEvent[propNames.length];
|
|
int eventCount= 0;
|
|
// get a snapshot of the current property values
|
|
synchronized (this)
|
|
{
|
|
for (int i= 0; i < propNames.length; i++)
|
|
{
|
|
Property prop= getProperty(propNames[i]);
|
|
if (prop != null)
|
|
{
|
|
Object value= null;
|
|
try
|
|
{
|
|
value= getPropertyValue(prop);
|
|
}
|
|
catch(Exception e)
|
|
{
|
|
continue;
|
|
}
|
|
arEvents[eventCount]= new PropertyChangeEvent(this, prop.Name,
|
|
false, prop.Handle, value, value);
|
|
eventCount++;
|
|
}
|
|
}
|
|
}
|
|
|
|
// fire events from unsynchronized section so as to prevent deadlocks
|
|
if (eventCount > 0)
|
|
{
|
|
// Reallocate the array of the events if necessary
|
|
if (arEvents.length != eventCount)
|
|
{
|
|
PropertyChangeEvent[] arPropsTmp= new PropertyChangeEvent[eventCount];
|
|
System.arraycopy(arEvents, 0, arPropsTmp, 0, eventCount);
|
|
arEvents= arPropsTmp;
|
|
}
|
|
listener.propertiesChange(arEvents);
|
|
}
|
|
}
|
|
// XMultiPropertySet -----------------------------------------------------------------------------------
|
|
/** If a value for a property could not be retrieved then the respective element in the returned
|
|
* array has the value null.
|
|
*/
|
|
public Object[] getPropertyValues(String[] propNames)
|
|
{
|
|
Object[] arValues= new Object[propNames.length];
|
|
synchronized (this)
|
|
{
|
|
for (int i= 0; i < propNames.length; i++)
|
|
{
|
|
Object value= null;
|
|
try
|
|
{
|
|
value= getPropertyValue(propNames[i]);
|
|
}
|
|
catch (Exception e)
|
|
{
|
|
}
|
|
arValues[i]= value;
|
|
}
|
|
}
|
|
return arValues;
|
|
}
|
|
// XMultiPropertySet -----------------------------------------------------------------------------------
|
|
public void removePropertiesChangeListener(XPropertiesChangeListener xPropertiesChangeListener)
|
|
{
|
|
listenerContainer.removeInterface(XPropertiesChangeListener.class, xPropertiesChangeListener);
|
|
}
|
|
// XMultiPropertySet -----------------------------------------------------------------------------------
|
|
/** If the array of property names contains an unknown property then it will be ignored.
|
|
*/
|
|
public void setPropertyValues(String[] propNames, Object[] values) throws PropertyVetoException, com.sun.star.lang.IllegalArgumentException, com.sun.star.lang.WrappedTargetException
|
|
{
|
|
for (int i= 0; i < propNames.length; i++)
|
|
{
|
|
try
|
|
{
|
|
setPropertyValue(propNames[i], values[i]);
|
|
}
|
|
catch (UnknownPropertyException e)
|
|
{
|
|
continue;
|
|
}
|
|
|
|
}
|
|
}
|
|
|
|
private class PropertySetInfo implements XPropertySetInfo
|
|
{
|
|
public com.sun.star.beans.Property[] getProperties()
|
|
{
|
|
return PropertySet.this.getProperties();
|
|
}
|
|
|
|
public com.sun.star.beans.Property getPropertyByName(String name) throws UnknownPropertyException
|
|
{
|
|
return getProperty(name);
|
|
}
|
|
|
|
public boolean hasPropertyByName(String name)
|
|
{
|
|
return getProperty(name) != null;
|
|
}
|
|
|
|
}
|
|
}
|
|
|
|
|
|
|
|
|
|
|