Added GettingStarted and GenerateOrderDetails examples

docio/generateorderdetails/CustomerDetails.java

@@ -0,0 +1,82 @@
+package generateorderdetails;
+
+import com.syncfusion.javahelper.system.collections.generic.ListSupport;
+
+public class CustomerDetails {
+	private String m_customerName;
+	private String m_address;
+	private String m_city;
+	private String m_postalCode;
+	private String m_country;
+	private String m_phone;
+	private ListSupport<OrderDetails> m_orders;
+
+	public String getCustomerName() throws Exception {
+		return m_customerName;
+	}
+
+	public String setCustomerName(String value) throws Exception {
+		m_customerName = value;
+		return value;
+	}
+
+	public String getAddress() throws Exception {
+		return m_address;
+	}
+
+	public String setAddress(String value) throws Exception {
+		m_address = value;
+		return value;
+	}
+
+	public String getCity() throws Exception {
+		return m_city;
+	}
+
+	public String setCity(String value) throws Exception {
+		m_city = value;
+		return value;
+	}
+
+	public String getPostalCode() throws Exception {
+		return m_postalCode;
+	}
+
+	public String setPostalCode(String value) throws Exception {
+		m_postalCode = value;
+		return value;
+	}
+
+	public String getCountry() throws Exception {
+		return m_country;
+	}
+
+	public String setCountry(String value) throws Exception {
+		m_country = value;
+		return value;
+	}
+
+	public String getPhone() throws Exception {
+		return m_phone;
+	}
+
+	public String setPhone(String value) throws Exception {
+		m_phone = value;
+		return value;
+	}
+
+	public ListSupport<OrderDetails> getOrders() throws Exception {
+		if (m_orders == null)
+			m_orders = new ListSupport<OrderDetails>(OrderDetails.class);
+		return m_orders;
+	}
+
+	public ListSupport<OrderDetails> setOrders(ListSupport<OrderDetails> value) throws Exception {
+		m_orders = value;
+		return value;
+	}
+
+	public CustomerDetails() throws Exception {
+		m_orders = new ListSupport<OrderDetails>(OrderDetails.class);
+	}
+}

docio/generateorderdetails/GenerateOrderDetails.java

@@ -0,0 +1,295 @@
+package generateorderdetails;
+
+import java.io.FileInputStream;
+import com.syncfusion.docio.*;
+import com.syncfusion.javahelper.system.ObjectSupport;
+import com.syncfusion.javahelper.system.RefSupport;
+import com.syncfusion.javahelper.system.StringSupport;
+import com.syncfusion.javahelper.system.collections.DictionaryEntrySupport;
+import com.syncfusion.javahelper.system.collections.generic.DictionarySupport;
+import com.syncfusion.javahelper.system.collections.generic.IDictionarySupport;
+import com.syncfusion.javahelper.system.collections.generic.IEnumeratorSupport;
+import com.syncfusion.javahelper.system.collections.generic.ListSupport;
+import com.syncfusion.javahelper.system.io.*;
+import com.syncfusion.javahelper.system.xml.XmlDocumentSupport;
+import com.syncfusion.javahelper.system.xml.XmlNodeSupport;
+import com.syncfusion.javahelper.system.xml.XmlNodeType;
+import com.syncfusion.javahelper.system.xml.XmlReaderSupport;
+import java.io.File;
+
+public class GenerateOrderDetails {
+
+	public static void main(String[] args) throws Exception {
+		//Creates new Word document instance for Word processing.
+		WordDocument document = new WordDocument();
+		//Opens the template Word document.
+		String basePath = getDataDir("Template.docx");
+		document.open(basePath, FormatType.Docx);
+		//Retrieves the mail merge data.
+		MailMergeDataTable dataTable = getMailMergeDataTable();
+		//Executes nested Mail merge using implicit relational data.
+		document.getMailMerge().executeNestedGroup(dataTable);
+		//Removes empty page at the end of Word document.
+		removeEmptyPage(document);
+		//Save the document in the given name and format.
+		document.save("Sample.docx", FormatType.Docx);
+		//Release the resources occupied by the WordDocument instance.
+		System.out.println("Word document generated successfully.");
+	}
+
+	/**
+	 * 
+	 * Gets the mail merge data table.
+	 * 
+	 * @return
+	 * @exception System.Exception reader
+	 * @exception XmlException     Unexpected xml tag + reader.LocalName
+	 */
+	private static MailMergeDataTable getMailMergeDataTable() throws Exception {
+		// Gets the employee details implicit as "IEnumerable" collection.
+		ListSupport<CustomerDetails> customers = new ListSupport<CustomerDetails>(CustomerDetails.class);
+		FileStreamSupport stream = new FileStreamSupport(getDataDir("CustomerDetails.xml"), FileMode.OpenOrCreate);
+		XmlReaderSupport reader = XmlReaderSupport.create(stream);
+		if (reader == null)
+			throw new Exception("reader");
+		while (reader.getNodeType().getEnumValue() != XmlNodeType.Element.getEnumValue())
+			reader.read();
+		if (!(reader.getLocalName() == "CustomerDetails"))
+			throw new Exception("Unexpected xml tag " + reader.getLocalName());
+		reader.read();
+		while (reader.getNodeType().getEnumValue() == XmlNodeType.Whitespace.getEnumValue())
+			reader.read();
+		while (!(reader.getLocalName() == "CustomerDetails")) {
+			if (reader.getNodeType().getEnumValue() == XmlNodeType.Element.getEnumValue()) {
+				switch ((reader.getLocalName()) == null ? "string_null_value" : (reader.getLocalName())) {
+				case "Customers":
+					customers.add(getCustomer(reader));
+					break;
+				}
+			} else
+			{
+				reader.read();
+				if ((reader.getLocalName() == "CustomerDetails")
+						&& reader.getNodeType().getEnumValue() == XmlNodeType.EndElement.getEnumValue())
+					break;
+			}
+		}
+		reader.close();
+		stream.close();
+		// Creates an instance of "MailMergeDataTable" by specifying mail merge group
+		// name and "IEnumerable" collection.
+		MailMergeDataTable dataTable = new MailMergeDataTable("Customers", customers);
+		return dataTable;
+	}
+
+	/**
+	 * 
+	 * Gets the customer.
+	 * 
+	 * @param reader The reader.
+	 * @return
+	 * @exception System.Exception reader
+	 * @exception XmlException     Unexpected xml tag + reader.LocalName
+	 */
+	private static CustomerDetails getCustomer(XmlReaderSupport reader) throws Exception {
+		if (reader == null)
+			throw new Exception("reader");
+		while (reader.getNodeType().getEnumValue() != XmlNodeType.Element.getEnumValue())
+			reader.read();
+		if (!(reader.getLocalName() == "Customers"))
+			throw new Exception("Unexpected xml tag " + reader.getLocalName());
+		reader.read();
+		while (reader.getNodeType().getEnumValue() == XmlNodeType.Whitespace.getEnumValue())
+			reader.read();
+		CustomerDetails customer = new CustomerDetails();
+		while (!(reader.getLocalName() == "Customers")) {
+			if (reader.getNodeType().getEnumValue() == XmlNodeType.Element.getEnumValue()) {
+				switch ((reader.getLocalName()) == null ? "string_null_value" : (reader.getLocalName())) {
+				case "CustomerName":
+					customer.setCustomerName(reader.readContentAsString());
+					break;
+				case "Address":
+					customer.setAddress(reader.readContentAsString());
+					break;
+				case "City":
+					customer.setCity(reader.readContentAsString());
+					break;
+				case "PostalCode":
+					customer.setPostalCode(reader.readContentAsString());
+					break;
+				case "Country":
+					customer.setCountry(reader.readContentAsString());
+					break;
+				case "Phone":
+					customer.setPhone(reader.readContentAsString());
+					break;
+				case "Orders":
+					customer.getOrders().add(getOrder(reader));
+					break;
+				default:
+					reader.skip();
+					break;
+				}
+			} else
+			{
+				reader.read();
+				if ((reader.getLocalName() == "Customers")
+						&& reader.getNodeType().getEnumValue() == XmlNodeType.EndElement.getEnumValue())
+					break;
+			}
+		}
+		return customer;
+	}
+
+	/**
+	 * 
+	 * Gets the order.
+	 * 
+	 * @param reader The reader.
+	 * @return
+	 * @exception System.Exception reader
+	 * @exception XmlException     Unexpected xml tag + reader.LocalName
+	 */
+	private static OrderDetails getOrder(XmlReaderSupport reader) throws Exception {
+		if (reader == null)
+			throw new Exception("reader");
+		while (reader.getNodeType().getEnumValue() != XmlNodeType.Element.getEnumValue())
+			reader.read();
+		if (!(reader.getLocalName() == "Orders"))
+			throw new Exception("Unexpected xml tag " + reader.getLocalName());
+		reader.read();
+		while (reader.getNodeType().getEnumValue() == XmlNodeType.Whitespace.getEnumValue())
+			reader.read();
+		OrderDetails order = new OrderDetails();
+		while (!(reader.getLocalName() == "Orders")) {
+			if (reader.getNodeType().getEnumValue() == XmlNodeType.Element.getEnumValue()) {
+				switch ((reader.getLocalName()) == null ? "string_null_value" : (reader.getLocalName())) {
+				case "CustomerName":
+					order.setCustomerName(reader.readContentAsString());
+					break;
+				case "OrderID":
+					order.setOrderID(reader.readContentAsString());
+					break;
+				case "OrderDate":
+					order.setOrderDate(reader.readContentAsString());
+					break;
+				case "ExpectedDeliveryDate":
+					order.setExpectedDeliveryDate(reader.readContentAsString());
+					break;
+				case "ShippedDate":
+					order.setShippedDate(reader.readContentAsString());
+					break;
+				case "Products":
+					order.getProducts().add(getProduct(reader));
+					break;
+				}
+				reader.read();
+			} else
+			{
+				reader.read();
+				if ((reader.getLocalName() == "Orders")
+						&& reader.getNodeType().getEnumValue() == XmlNodeType.EndElement.getEnumValue())
+					break;
+			}
+		}
+		return order;
+	}
+
+	/**
+	 * 
+	 * Gets the product.
+	 * 
+	 * @param reader The reader.
+	 * @return
+	 * @exception System.Exception reader
+	 * @exception XmlException     Unexpected xml tag + reader.LocalName
+	 */
+	private static ProductDetails getProduct(XmlReaderSupport reader) throws Exception {
+		if (reader == null)
+			throw new Exception("reader");
+		while (reader.getNodeType().getEnumValue() != XmlNodeType.Element.getEnumValue())
+			reader.read();
+		if (!(reader.getLocalName() == "Products"))
+			throw new Exception("Unexpected xml tag " + reader.getLocalName());
+		reader.read();
+		while (reader.getNodeType().getEnumValue() == XmlNodeType.Whitespace.getEnumValue())
+			reader.read();
+		ProductDetails product = new ProductDetails();
+		while (!(reader.getLocalName() == "Products")) {
+			if (reader.getNodeType().getEnumValue() != XmlNodeType.EndElement.getEnumValue()) {
+				switch ((reader.getLocalName()) == null ? "string_null_value" : (reader.getLocalName())) {
+				case "OrderID":
+					product.setOrderID(reader.readContentAsString());
+					break;
+				case "Product":
+					product.setProduct(reader.readContentAsString());
+					break;
+				case "UnitPrice":
+					product.setUnitPrice(reader.readContentAsString());
+					break;
+				case "Quantity":
+					product.setQuantity(reader.readContentAsString());
+					break;
+				}
+				reader.read();
+			} else
+			{
+				reader.read();
+				if ((reader.getLocalName() == "Products")
+						&& reader.getNodeType().getEnumValue() == XmlNodeType.EndElement.getEnumValue())
+					break;
+			}
+		}
+		return product;
+	}
+
+	/**
+	 * 
+	 * Removes empty paragraphs from the end of Word document.
+	 * 
+	 * @param document The Word document
+	 */
+	private static void removeEmptyPage(WordDocument document) throws Exception {
+		WTextBody textBody = document.getLastSection().getBody();
+		boolean IsRenderableItem = false;
+		for (int itemIndex = textBody.getChildEntities().getCount() - 1; itemIndex >= 0
+				&& !IsRenderableItem; itemIndex--) {
+			if (textBody.getChildEntities().get(itemIndex) instanceof WParagraph) {
+				WParagraph paragraph = (WParagraph) ObjectSupport.instanceOf(textBody.getChildEntities().get(itemIndex),
+						WParagraph.class);
+				for (int pIndex = paragraph.getItems().getCount() - 1; pIndex >= 0; pIndex--) {
+					ParagraphItem paragraphItem = paragraph.getItems().get(pIndex);
+					if ((paragraphItem instanceof Break
+							&& ((Break) ObjectSupport.instanceOf(paragraphItem, Break.class)).getBreakType()
+									.getEnumValue() == BreakType.PageBreak.getEnumValue()))
+						paragraph.getItems().removeAt(pIndex);
+					else
+
+					if (!(paragraphItem instanceof BookmarkStart || paragraphItem instanceof BookmarkEnd)) {
+						IsRenderableItem = true;
+						break;
+					}
+				}
+				if (paragraph.getItems().getCount() == 0 || !IsRenderableItem)
+					textBody.getChildEntities().removeAt(itemIndex);
+			}
+		}
+	}
+
+	/**
+	 * Get the file path
+	 * 
+	 * @param path specifies the file path
+	 */
+	public static String getDataDir(String path) {
+		File dir = new File(System.getProperty("user.dir"));
+		if (!(dir.toString().endsWith("samples")))
+			dir = dir.getParentFile();
+		dir = new File(dir, "resources");
+		dir = new File(dir, path);
+		if (dir.isDirectory() == false)
+			dir.mkdir();
+		return dir.toString();
+	}
+
+}