17c478bd9Sstevel@tonic-gate /*
27c478bd9Sstevel@tonic-gate  * CDDL HEADER START
37c478bd9Sstevel@tonic-gate  *
47c478bd9Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
57c478bd9Sstevel@tonic-gate  * Common Development and Distribution License, Version 1.0 only
67c478bd9Sstevel@tonic-gate  * (the "License").  You may not use this file except in compliance
77c478bd9Sstevel@tonic-gate  * with the License.
87c478bd9Sstevel@tonic-gate  *
97c478bd9Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
107c478bd9Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
117c478bd9Sstevel@tonic-gate  * See the License for the specific language governing permissions
127c478bd9Sstevel@tonic-gate  * and limitations under the License.
137c478bd9Sstevel@tonic-gate  *
147c478bd9Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
157c478bd9Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
167c478bd9Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
177c478bd9Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
187c478bd9Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
197c478bd9Sstevel@tonic-gate  *
207c478bd9Sstevel@tonic-gate  * CDDL HEADER END
217c478bd9Sstevel@tonic-gate  */
227c478bd9Sstevel@tonic-gate /*
237c478bd9Sstevel@tonic-gate  * Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
247c478bd9Sstevel@tonic-gate  * Use is subject to license terms.
257c478bd9Sstevel@tonic-gate  *
267c478bd9Sstevel@tonic-gate  */
277c478bd9Sstevel@tonic-gate 
287c478bd9Sstevel@tonic-gate package com.sun.solaris.service.pools;
297c478bd9Sstevel@tonic-gate 
307c478bd9Sstevel@tonic-gate /**
317c478bd9Sstevel@tonic-gate  * The <code>Property</code> interface specifies the contract between
32*99308ed0SPeter Tribble  * a pools configuration element and its properties. This interface
337c478bd9Sstevel@tonic-gate  * must be implemented by all pools configuration elements to ensure that
347c478bd9Sstevel@tonic-gate  * properties can be manipulated.
357c478bd9Sstevel@tonic-gate  */
367c478bd9Sstevel@tonic-gate 
377c478bd9Sstevel@tonic-gate public interface Property {
387c478bd9Sstevel@tonic-gate 	/**
397c478bd9Sstevel@tonic-gate 	 * Get a property with the supplied name.
407c478bd9Sstevel@tonic-gate 	 *
417c478bd9Sstevel@tonic-gate 	 * @param name The name of the property to be retrieved.
42*99308ed0SPeter Tribble 	 * @throws PoolsException If there is an error accessing the property.
437c478bd9Sstevel@tonic-gate 	 */
getBoolProperty(String name)447c478bd9Sstevel@tonic-gate 	public boolean getBoolProperty(String name) throws PoolsException;
457c478bd9Sstevel@tonic-gate 
467c478bd9Sstevel@tonic-gate 	/**
477c478bd9Sstevel@tonic-gate 	 * Get a property with the supplied name.
487c478bd9Sstevel@tonic-gate 	 *
497c478bd9Sstevel@tonic-gate 	 * @param name The name of the property to be retrieved.
50*99308ed0SPeter Tribble 	 * @throws PoolsException If there is an error accessing the property.
517c478bd9Sstevel@tonic-gate 	 */
getDoubleProperty(String name)527c478bd9Sstevel@tonic-gate 	public double getDoubleProperty(String name) throws PoolsException;
537c478bd9Sstevel@tonic-gate 
547c478bd9Sstevel@tonic-gate 	/**
557c478bd9Sstevel@tonic-gate 	 * Get a property with the supplied name.
567c478bd9Sstevel@tonic-gate 	 *
577c478bd9Sstevel@tonic-gate 	 * @param name The name of the property to be retrieved.
58*99308ed0SPeter Tribble 	 * @throws PoolsException If there is an error accessing the property.
597c478bd9Sstevel@tonic-gate 	 */
getLongProperty(String name)607c478bd9Sstevel@tonic-gate 	public long getLongProperty(String name) throws PoolsException;
617c478bd9Sstevel@tonic-gate 
627c478bd9Sstevel@tonic-gate 	/**
637c478bd9Sstevel@tonic-gate 	 * Get a property with the supplied name.
647c478bd9Sstevel@tonic-gate 	 *
657c478bd9Sstevel@tonic-gate 	 * @param name The name of the property to be retrieved.
66*99308ed0SPeter Tribble 	 * @throws PoolsException If there is an error accessing the property.
677c478bd9Sstevel@tonic-gate 	 */
getStringProperty(String name)687c478bd9Sstevel@tonic-gate 	public String getStringProperty(String name) throws PoolsException;
697c478bd9Sstevel@tonic-gate 
707c478bd9Sstevel@tonic-gate 	/**
717c478bd9Sstevel@tonic-gate 	 * Put the supplied value as a property with the supplied name.
727c478bd9Sstevel@tonic-gate 	 *
737c478bd9Sstevel@tonic-gate 	 * @param name The name of the property to be updated.
747c478bd9Sstevel@tonic-gate 	 * @param value The value of the property to be updated.
75*99308ed0SPeter Tribble 	 * @throws PoolsException If there is an error accessing the property.
767c478bd9Sstevel@tonic-gate 	 */
putProperty(String name, Value value)777c478bd9Sstevel@tonic-gate 	public void putProperty(String name, Value value) throws PoolsException;
787c478bd9Sstevel@tonic-gate 
797c478bd9Sstevel@tonic-gate 	/**
807c478bd9Sstevel@tonic-gate 	 * Remove the property with the supplied name.
817c478bd9Sstevel@tonic-gate 	 *
827c478bd9Sstevel@tonic-gate 	 * @param name The name of the property to be removed.
83*99308ed0SPeter Tribble 	 * @throws PoolsException If there is an error removing the property.
847c478bd9Sstevel@tonic-gate 	 */
rmProperty(String name)857c478bd9Sstevel@tonic-gate 	public void rmProperty(String name) throws PoolsException;
867c478bd9Sstevel@tonic-gate }
87