Examples of org.jbpm.pvm.internal.env.Environment

org.jbpm.pvm.internal.env.Environment
maintains contextual information for a thread in a set of {@link Context}s.
Introduction

Objects have different lifecycles and different context's (aka scopes). An environment provides the structure to easily manage objects with different contexts.

Examples of contexts are:
- process-engine: The process-engine context is used to store e.g. data sources, session factories and other static resources needed by an application. The process-engine context lives for the complete duration of the {@link EnvironmentFactory}. So if the {@link EnvironmentFactory} is maintained in a static member field, the process-engine context lives for the duration of the application. The same process-engine context is shared for all the Environments produced by one EnvironmentFactory.
- environment: The environment context is used for e.g. a transaction and transactional resources, user authentication. This results in an efficient and configurable use of transactional resources that need to be lazily initialized.
- The environment can accomodate other contexts as well. They can be added and removed dynamically. Examples of other potential contexts are web-request, web-session, web-application, business processDefinition, jobImpl, ...
An environment is typically installed like this
static EnvironmentFactory environmentFactory = new DefaultEnvironmentFactory(); ... Environment environment = environmentFactory.openEnvironment(); try { ... everything available in this block ... } finally { environment.close(); }

Purpose

The first purpose of the environment is to separate the application from the environment. Standard Java and Enterprise Java are quite different and an environment abstraction like this allows for the development of applications that can run in both Standard and Enterprise environments. Also test environments are easier to tweak this way.

A second purpose of the environment is to enable specific to global searching of resources. E.g. you could search for an 'adminEmailAddress' in the contexts 'execution', 'transaction' and 'process-engine' in the given order. That way, a global adminEmailAddress can be specified in the process-engine context and it can be refined in more specific contexts.

Search order

To find an object in the environment, a searchOrder can be specified. A search order is an sequence that specifies the order in which the contexts should be searched.

The default search order is the inverse sequence of how the contexts are added to the environment. This is because in general, we can assume that the more recent a context was added, the more specific it is.

Transaction, username and classloader

Three objects are used so frequently in an environment that they get special treatment:
- Transaction: an abstraction for marking a transaction with setRollbackOnly.
- Classloader: the current class loader.
- Username: the name of the currently authenticated user.
For these special properties, setters are also available. That is to support programmatic injection into the environment. Alternatively, they can be configured in one of the contexts.
@see EnvironmentFactory @author Tom Baeyens

  }


  public ProcessDefinitionRef getProcessDefinition(String procDefId)
  {


    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {
      RepositoryService repositoryService = this.processEngine.getRepositoryService();
      ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery()
          .processDefinitionId(procDefId)
          .uniqueResult();
      return ModelAdaptor.adoptDefinition(processDefinition);


    }
    finally
    {
      env.close();
    }
  }

View Full Code Here

    }
  }


  public List<ProcessDefinitionRef> removeProcessDefinition(String procDefId)
  {
    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {


      RepositoryService repositoryService = this.processEngine.getRepositoryService();
      ProcessDefinition processDefinition = repositoryService.createProcessDefinitionQuery()
          .processDefinitionId(procDefId)
          .uniqueResult();
      if (processDefinition!=null) {
        repositoryService.deleteDeploymentCascade(processDefinition.getDeploymentId());
      }
      return getProcessDefinitions();
    }
    finally
    {
      env.close();
    }
  }

View Full Code Here

    }
  }


  public List<ProcessInstanceRef> getProcessInstances(String procDefId)
  {
    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {


      ExecutionService execService = this.processEngine.getExecutionService();
      ProcessInstanceQuery query = execService.createProcessInstanceQuery();
      query.processDefinitionId(String.valueOf(procDefId));


      List<ProcessInstance> processInstances = query.list();


      List<ProcessInstanceRef> results = adoptProcessInstances(processInstances);


      // add history info
      // TODO: optimize w. batch query 
      HistoryService histService = this.processEngine.getHistoryService();
      for(ProcessInstanceRef inst : results)
      {
        HistoryProcessInstanceQuery hQuery = histService.createHistoryProcessInstanceQuery();
        hQuery.processInstanceId(inst.getId());
        HistoryProcessInstance entry = hQuery.uniqueResult();
        inst.setStartDate(entry.getStartTime());
      }


      return results;
    }
    finally
    {
      env.close();
    }
  }

View Full Code Here

    }
  }


  private List<ProcessInstanceRef> adoptProcessInstances(List<ProcessInstance> processInstances)
  {
    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {


      List<ProcessInstanceRef> results = new ArrayList<ProcessInstanceRef>();
      for(Execution processInstance : processInstances)
      {
        if(processInstance.isEnded())
        {
          //JBPM-2055: Execution is already ended. Should not show up in query
          continue;
        }


        if(processInstance.isProcessInstance()) // parent execution
        {
          results.add( ModelAdaptor.adoptExecution((ExecutionImpl)processInstance) );
        }
      }
      return results;
    }
    finally
    {
      env.close();
    }
  }

View Full Code Here

    }
  }


  public ProcessInstanceRef getProcessInstance(String instanceId)
  {
    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {
      ExecutionService execService = this.processEngine.getExecutionService();
      ProcessInstanceQuery query = execService.createProcessInstanceQuery();
      query.processInstanceId(instanceId);
      ProcessInstance processInstance = query.uniqueResult();
      return ModelAdaptor.adoptExecution( (ExecutionImpl)processInstance);
    }
    finally
    {
      env.close();
    }
  }

View Full Code Here


  public Map<String, Object> getInstanceData(String instanceId)
  {
    Map<String, Object> data = new HashMap<String, Object>();


    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {
      ExecutionService execService = this.processEngine.getExecutionService();
      Set<String> keys = execService.getVariableNames(instanceId);
      data = execService.getVariables(instanceId, keys);
    }
    finally
    {
      env.close();
    }


    return data;
  }

View Full Code Here

    throw new RuntimeException("Not implemented");
  }


  public ProcessInstanceRef newInstance(String definitionId)
  {
    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {
      ExecutionService execService = this.processEngine.getExecutionService();
      Execution exec = execService.startProcessInstanceById(definitionId);
      return ModelAdaptor.adoptExecution((ExecutionImpl)exec);
    }
    finally{
      env.close();
    }
  }

View Full Code Here

  }




  public ProcessInstanceRef newInstance(String definitionId, Map<String, Object> processVars)
  {
    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {
      ExecutionService execService = this.processEngine.getExecutionService();
      Execution exec = execService.startProcessInstanceById(definitionId);
      execService.setVariables(exec.getId(), processVars);
      
      return ModelAdaptor.adoptExecution((ExecutionImpl)exec);
    }
    finally{
      env.close();
    }
  }

View Full Code Here

    }
  }


  public void endInstance(String instanceId, ProcessInstanceRef.RESULT result)
  {
    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {


      ExecutionService execService = this.processEngine.getExecutionService();
      Execution exec = execService.findExecutionById(instanceId);
      if(null==exec)
        throw new IllegalArgumentException("No such execution with id "+ instanceId);


      ProcessInstanceRef.RESULT actualResult = result!=null ? result : ProcessInstanceRef.RESULT.COMPLETED;
      execService.endProcessInstance(instanceId, actualResult.toString());
    }
    finally
    {
      env.close();
    }
  }

View Full Code Here

    }
  }


  public void deleteInstance(String instanceId)
  {
    Environment env = ((EnvironmentFactory)processEngine).openEnvironment();


    try
    {


      ExecutionService execService = this.processEngine.getExecutionService();
      Execution exec = execService.findExecutionById(instanceId);
      if(null==exec)
        throw new IllegalArgumentException("No such execution with id "+ instanceId);


      execService.deleteProcessInstance(instanceId);
    }
    finally
    {
      env.close();
    }
  }

View Full Code Here

0 1 2 3 4 5 6

TOP

Related Classes of org.jbpm.pvm.internal.env.Environment

org.jbpm.integration.console.forms.ProcessFormDispatcher

org.jbpm.integration.console.forms.TaskFormDispatcher

org.jbpm.integration.console.graphView.GraphViewerPluginImpl

org.jbpm.integration.console.ProcessEnginePluginImpl

org.jbpm.integration.console.ProcessManagementImpl

org.jbpm.integration.console.TaskManagementImpl

org.jbpm.jpdl.internal.activity.DecisionHandlerActivity

org.jbpm.jpdl.internal.activity.HqlActivity

org.jbpm.jpdl.internal.activity.MailListener

org.jbpm.jpdl.internal.activity.SubProcessActivity

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of org.jbpm.pvm.internal.env.Environment

Introduction

Purpose

Search order

Transaction, username and classloader

Related Classes of org.jbpm.pvm.internal.env.Environment