| /* |
| * 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 |
| * |
| * 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.apache.polygene.bootstrap; |
| |
| import org.apache.polygene.api.activation.Activator; |
| import org.apache.polygene.api.structure.Application; |
| |
| /** |
| * An application assembly. This can be used by Assemblers to programmatically |
| * set the name of the application and create new layers. |
| */ |
| public interface ApplicationAssembly |
| { |
| /** |
| * Create a new layer assembly |
| * |
| * @param name of the new layer |
| * |
| * @return a LayerAssembly instance |
| */ |
| LayerAssembly layer( String name ); |
| |
| /** |
| * Get an assembly for a particular Module. If this is called many times with the same names, then the same module |
| * is affected. |
| * |
| * @param layerName The name of the Layer |
| * @param moduleName The name of the Module to retrieve or create. |
| * @return The ModuleAssembly for the Module. |
| */ |
| ModuleAssembly module( String layerName, String moduleName ); |
| |
| /** |
| * Get the currently set name of the application |
| * |
| * @return the name of the application |
| */ |
| String name(); |
| |
| /** |
| * Get the currently set version of the application |
| * |
| * @return the version of the application |
| */ |
| String version(); |
| |
| /** |
| * Get the currently set mode of the application |
| * |
| * @return the application mode |
| */ |
| Application.Mode mode(); |
| |
| /** |
| * Set the name of the application |
| * |
| * @param name of the application |
| * |
| * @return the assembly |
| */ |
| ApplicationAssembly setName( String name ); |
| |
| /** |
| * Set the version of the application. This can be in any format, but |
| * most likely will follow the Dewey format, i.e. x.y.z. |
| * |
| * @param version of the application |
| * |
| * @return the assembly |
| */ |
| ApplicationAssembly setVersion( String version ); |
| |
| /** |
| * Set the application mode. This will be set to "production" by default. You can |
| * set the system property "mode" to either "development", "satisfiedBy" or "production" |
| * to explicitly set the mode. If that is not an option, then call this method |
| * during assembly to set the mode. The mode may then be queried by assemblers, |
| * and they may assemble the application differentlly depending on this setting. |
| * |
| * @param mode the application mode |
| * |
| * @return the assembly |
| */ |
| ApplicationAssembly setMode( Application.Mode mode ); |
| |
| ApplicationAssembly setMetaInfo( Object info ); |
| |
| /** |
| * Set the application activators. Activators are executed in order around the |
| * Application activation and passivation. |
| * |
| * @param activators the application activators |
| * @return the assembly |
| */ |
| @SuppressWarnings( { "unchecked","varargs" } ) |
| ApplicationAssembly withActivators( Class<? extends Activator<Application>>... activators ); |
| |
| <ThrowableType extends Throwable> void visit( AssemblyVisitor<ThrowableType> visitor ) |
| throws ThrowableType; |
| } |