Implementation of RCML Java Builder SDK.

README.md

@@ -18,3 +18,43 @@ To know more about Restcomm, please refer to http://documentation.telestax.com/
 
 Regarding issues, please refer to https://github.com/RestComm/restcomm-sdk-java/issues 
 
+### RCML Example of Use
+
+This example assumes you have a Java development environment with a Web server capable of running Java servlets, and the restcomm-sdk-java library.
+
+```java
+import org.restcomm.connect.java.sdk.rcml.Response;
+import org.restcomm.connect.java.sdk.rcml.Say;
+import org.restcomm.connect.java.sdk.rcml.VoiceType;
+
+/**
+ * This servlet represent a demo of use the Restcomm Java RCML library.
+ * @author Ricardo Limonta
+ */
+@WebServlet(name = "AgentDemo", urlPatterns = {"/agent"})
+public class AgentDemo extends HttpServlet {
+    @Override
+    protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
+        //Define a response content type
+        response.setContentType("application/xml");
+
+        //Create a RCML verb and return our welcome message
+        Response rcml = new Response().say(new Say()
+                                        .text("Welcome to Restcomm Connect!")
+                                        .language("en")
+                                        .voice(VoiceType.WOMAN)).build();
+        //Process response
+        response.getWriter().print(rcml.toXML());
+    }
+}
+```
+
+
+The result of the servlet execution will be:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<Response>
+    <Say voice="woman" language="en">Welcome to Restcomm Connect!</Say>
+</Response>
+```

restcomm-connect.java.sdk/.gitignore

@@ -0,0 +1 @@
+/target/

restcomm-connect.java.sdk/pom.xml

@@ -52,6 +52,11 @@
       <artifactId>wiremock-body-transformer</artifactId>
       <version>1.1.5</version>
     </dependency>
+    <dependency>
+    	<groupId>javax.xml.bind</groupId>
+    	<artifactId>jaxb-api</artifactId>
+    	<version>2.2</version>
+    </dependency>
   </dependencies>
   <build>
     <plugins>

restcomm-connect.java.sdk/src/main/java/org/restcomm/connect/java/sdk/rcml/Client.java

@@ -0,0 +1,93 @@
+/*
+ * TeleStax, Open Source Cloud Communications
+ * Copyright 2011-2016, Telestax Inc and individual contributors
+ * by the @authors tag.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+package org.restcomm.connect.java.sdk.rcml;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlAttribute;
+import javax.xml.bind.annotation.XmlValue;
+
+/**
+ * @author Kleber Damasco [email protected]
+ */
+@XmlAccessorType(XmlAccessType.FIELD)
+public class Client implements GenericBuilder<Client>{
+
+	@XmlAttribute
+	private String name;
+
+	@XmlAttribute
+	private String url;
+
+	@XmlAttribute
+	private String method;
+
+	@XmlAttribute
+	private String statusCallbackEvent;
+
+	@XmlAttribute
+	private String statusCallback;
+
+	@XmlAttribute
+	private String statusCallbackMethod;
+
+	@XmlValue
+	private String value;
+
+	public Client name(String name) {
+		this.name = name;
+		return this;
+	}
+	public Client url(String url) {
+		this.url = url;
+		return this;
+	}
+	public Client method(MethodType method) {
+		this.method = method.name();
+		return this;
+	}
+	public Client statusCallbackEvent(StatusCallbackType statusCallbackEvent) {
+		this.statusCallbackEvent = statusCallbackEvent.getName();
+		return this;
+	}
+	public Client statusCallback(String statusCallback) {
+		this.statusCallback = statusCallback;
+		return this;
+	}
+	public Client statusCallbackMethod(MethodType method) {
+		this.statusCallbackMethod = method.name();
+		return this;
+	}
+	public Client value(String value) {
+		this.value = value;
+		return this;
+	}
+
+	@Override
+	public String toString() {
+		return "Client [name=" + name + ", url=" + url + ", method=" + method + ", statusCallbackEvent="
+				+ statusCallbackEvent + ", statusCallback=" + statusCallback + ", statusCallbackMethod="
+				+ statusCallbackMethod + ", value=" + value + "]";
+	}
+	public Client build() {
+		return this;
+	}
+}

restcomm-connect.java.sdk/src/main/java/org/restcomm/connect/java/sdk/rcml/Conference.java

@@ -0,0 +1,103 @@
+/*
+ * TeleStax, Open Source Cloud Communications
+ * Copyright 2011-2016, Telestax Inc and individual contributors
+ * by the @authors tag.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+package org.restcomm.connect.java.sdk.rcml;
+
+import javax.xml.bind.annotation.XmlAccessType;
+import javax.xml.bind.annotation.XmlAccessorType;
+import javax.xml.bind.annotation.XmlAttribute;
+import javax.xml.bind.annotation.XmlValue;
+
+/**
+ * @author Kleber Damasco [email protected]
+ */
+@XmlAccessorType(XmlAccessType.FIELD)
+public class Conference implements GenericBuilder<Conference>{
+
+	@XmlAttribute
+	private String name;
+
+	@XmlAttribute
+	private Boolean muted;
+
+	@XmlAttribute
+	private Boolean beep;
+
+	@XmlAttribute
+	private Boolean startConferenceOnEnter;
+
+	@XmlAttribute
+	private Boolean endConferenceOnExit;
+
+	@XmlAttribute
+	private String waitUrl;
+
+	@XmlAttribute
+	private String waitMethod;
+
+	@XmlAttribute
+	private Integer maxParticipants;
+
+	@XmlValue
+	private String value;
+
+	public Conference maxParticipants(Integer maxParticipants) {
+		this.maxParticipants = maxParticipants;
+		return this;
+	}
+	public Conference waitMethod(MethodType waitMethod) {
+		this.waitMethod = waitMethod.name();
+		return this;
+	}
+	public Conference value(String value) {
+		this.value = value;
+		return this;
+	}
+	public Conference name(String name) {
+		this.name = name;
+		return this;
+	}
+	public Conference muted(Boolean muted) {
+		this.muted = muted;
+		return this;
+	}
+	public Conference beep(Boolean beep) {
+		this.beep = beep;
+		return this;
+	}
+	public Conference startConferenceOnEnter(Boolean startConferenceOnEnter) {
+		this.startConferenceOnEnter = startConferenceOnEnter;
+		return this;
+	}
+	public Conference endConferenceOnExit(Boolean endConferenceOnExit) {
+		this.endConferenceOnExit = endConferenceOnExit;
+		return this;
+	}
+
+	public Conference build() {
+		return this;
+	}
+	@Override
+	public String toString() {
+		return "Conference [name=" + name + ", muted=" + muted + ", beep=" + beep + ", startConferenceOnEnter="
+				+ startConferenceOnEnter + ", endConferenceOnExit=" + endConferenceOnExit + ", waitUrl=" + waitUrl
+				+ ", waitMethod=" + waitMethod + ", maxParticipants=" + maxParticipants + ", value=" + value + "]";
+	}
+}