/*
* Copyright (C) 2004-2008 Jive Software. All rights reserved.
*
* Licensed 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
*
* 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.jivesoftware.xmpp.workgroup;
import java.util.Collection;
/**
* <p>All workgroup entities have associated, custom properties to extend the basic workgroup capabilities.</p>
*
* @author Derek DeMoro
*/
public interface DbProperties {
/**
* Returns an extended property of the user. Each user can have an arbitrary number of extended
* properties. This lets particular skins or filters provide enhanced functionality that is not
* part of the base interface.
*
* @param name the name of the property to get.
* @return the value of the property
*/
public String getProperty(String name);
/**
* Sets an extended property of the user. Each user can have an arbitrary number of extended
* properties. This lets particular skins or filters provide enhanced functionality that is not
* part of the base interface. Property names and values must be valid Strings. If <tt>null</tt>
* or an empty length String is used, a NullPointerException will be thrown.
*
* @param name the name of the property to set.
* @param value the new value for the property.
* @throws UnauthorizedException if not allowed to edit.
*/
public void setProperty(String name, String value) throws UnauthorizedException;
/**
* Deletes an extended property. If the property specified by <code>name</code> does not exist,
* this method will do nothing.
*
* @param name the name of the property to delete.
* @throws UnauthorizedException if not allowed to edit.
*/
public void deleteProperty(String name) throws UnauthorizedException;
/**
* Returns an Iterator for all the names of the extended user properties.
*
* @return an Iterator for the property names.
*/
public Collection<String> getPropertyNames();
}