example-twitter

Tweet directly from the Tasklist - Spring Boot packaged

This example demonstrates how you can use BPM process and Tweeter API to build simple Twitter client. It uses camunda-bpm-spring-boot-starter-webapp and thus embed Tomcat as a web container.

The example contains:

• a process application with one process deployed on the Camunda engine
• custom forms to create and review the Tweet
• creates on startup an admin user "kermit" (password: kermit)

It also demonstrates the usage of application.yaml configuration file.

How is it done

1. To embed the Camunda Engine you must add following dependency to your pom.xml:

...
<dependency>
 <groupId>org.camunda.bpm.springboot</groupId>
 <artifactId>camunda-bpm-spring-boot-starter-webapp</artifactId>
 <version>3.0.0</version>
</dependency>
...

2. With Spring Boot you usually create an "application" class annotated with @SpringBootApplication. In order to have a Camunda process application registered, you can simply add the annotation @EnableProcessApplication to the same class and also include the processes.xml file in your META-INF folder:

@SpringBootApplication
@EnableProcessApplication
public class TwitterServletProcessApplication {

  public static void main(String[] args) {
    SpringApplication.run(TwitterServletProcessApplication.class, args);
  }
}

3. You can also put BPMN, CMMN and DMN files in your classpath, they will be automatically deployed and registered within the process application.

4. You can configure your Spring Boot application using application.yaml file. All possible Camunda-specific configuration parameters are listed here

5. This example provides two implementations for posting a Tweet:

• TweetContentOfflineDelegate (default) - will just print the tweet content on console
• TweetContentDelegate - will really post a tweet on http://twitter.com/#!/camunda_demo

You can switch between two implementations by changing the name of a Spring bean to tweetAdapter. This tweetAdapter bean is further referenced in the BPMN diagram via "Delegate expression" in a service task:

...
<serviceTask id="service_task_publish_on_twitter" name="Publish on Twitter" camunda:delegateExpression="#{tweetAdapter}">
  ...
</serviceTask>
...

Run the application and check the result

You can build the application by mvn clean install and then run it with java -jar command.

Go to http://localhost:8080, log in with "kermit/kermit", go to Tasklist and try to start the process and complete the tasks, observe log entries or the real tweet when TweetContentDelegate is used.