org.eclipse.osgi.service.resolver.PlatformAdmin Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of aspectjtools Show documentation

AspectJ tools most notably contains the AspectJ compiler (AJC). AJC applies aspects to Java classes during compilation, fully replacing Javac for plain Java classes and also compiling native AspectJ or annotation-based @AspectJ syntax. Furthermore, AJC can weave aspects into existing class files in a post-compile binary weaving step. This library is a superset of AspectJ weaver and hence also of AspectJ runtime.

There is a newer version: 1.9.22.1

Show newest version

/*******************************************************************************
 * Copyright (c) 2003, 2012 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *     Rob Harrop - SpringSource Inc. (bug 247522)
 *******************************************************************************/
package org.eclipse.osgi.service.resolver;

import org.osgi.framework.BundleException;

/**
 * Framework service which allows bundle programmers to inspect the bundles and
 * packages known to the Framework.  The PlatformAdmin service also allows bundles
 * with sufficient privileges to update the state of the framework by committing a new
 * configuration of bundles and packages.
 *
 * If present, there will only be a single instance of this service
 * registered with the Framework.
 * 
 * This interface is not intended to be implemented by clients.
 * 
 * @since 3.1
 * @noimplement This interface is not intended to be implemented by clients.
 */
public interface PlatformAdmin {

	/**
	 * Returns a mutable state representing the current system.
	 * 
	 * This is a convenience method, fully equivalent to
	 * getState(true).
	 * 
	 * @return a state representing the current framework.
	 */
	public State getState();

	/**
	 * Returns a state representing the current system. If there is need to make
	 * changes to the returned state, a mutable state must be requested.
	 * Otherwise, an immutable state should be requested. In this case, invoking
	 * any of the operations that could cause the state to be changed will throw
	 * an java.lang.UnsupportedOperationException.
	 * 
	 * If a mutable state is requested, the resulting state will not
	 * be resolved and the user objects from the system state bundle descriptions will
	 * not be copied.
	 * 
	 * @param mutable whether the returned state should mutable
	 * @return a state representing the current framework.
	 */
	public State getState(boolean mutable);

	/**
	 * Returns a state helper object. State helpers provide convenience methods
	 * for manipulating states.
	 * 
	 * A possible implementation for this
	 * method would provide the same single StateHelper instance to all clients.
	 * 
	 *
	 * @return a state helper
	 * @see StateHelper
	 */
	public StateHelper getStateHelper();

	/**
	 * Commit the differences between the current state and the given state.
	 * The given state must return true from State.isResolved() or an exception
	 * is thrown.  The resolved state is committed verbatim, as-is.
	 *
	 * @param state the future state of the framework
	 * @throws BundleException if the id of the given state does not match that of the
	 * 	current state or if the given state is not resolved.
	 */
	public void commit(State state) throws BundleException;

	/**
	 * Returns a resolver supplied by the system.  The returned resolver
	 * will not be associated with any state.
	 * @return a system resolver
	 * @deprecated in favour of {@link #createResolver()}.
	 */
	public Resolver getResolver();

	/**
	 * Creates a new {@link Resolver} that is not associated with any {@link State}.
	 * @return the new Resolver.
	 * @since 3.5
	 */
	public Resolver createResolver();

	/**
	 * Returns a factory that knows how to create state objects, such as bundle
	 * descriptions and the different types of version constraints.
	 * @return a state object factory
	 */
	public StateObjectFactory getFactory();

	/**
	 * Adds the disabled info to the state managed by this platform admin.
	 *  If a disable info already exists for the specified policy and the specified bundle
	 *  then it is replaced with the given disabled info.
	 * @param disabledInfo the disabled info to add.
	 * @throws IllegalArgumentException if the BundleDescription for
	 * the specified disabled info does not exist in the state managed by this platform admin.
	 * @since 3.4
	 */
	public void addDisabledInfo(DisabledInfo disabledInfo);

	/**
	 * Removes the disabled info from the state managed by this platform admin.
	 * @param disabledInfo the disabled info to remove
	 * @since 3.4
	 */
	public void removeDisabledInfo(DisabledInfo disabledInfo);
}