Add ITablesHandler (#108)

https://dev.untill.com/projects/#!691698

Co-authored-by: sda <[email protected]>

README.md

@@ -44,6 +44,7 @@ To provide certain functionality which can be used by unTill(r) POS, driver must
 - [ITimeAttendance](docs/time_and_attendance.md) - implement for handling time and attendance operations (clock in, end break)
 - [IPosPrinter](docs/pos_printer.md) - implement for handling POS printer operations (print, upload logo)
 - [IExportHandler](docs/export_handler.md) - implement for handling exports
+- [ITablesHandler](docs/tables_handler.md) - implement for handling table events
 
 Declaration of supported interfaces is made by `init` method which is called at driver initialization stage. Driver must return a map of supported interfaces:
 ```java

docs/tables_handler.md

@@ -0,0 +1,18 @@
+# Tables operations handler - ITablesHandler
+POS invokes this interface when
+- Table is dirty
+- Table is clean
+  Example implementation
+```java
+public class TablesHandler implements ITablesHandler {
+
+	@Override
+	public void operation(DriverConfiguration cfg, TableChangedRequest req) {
+		if (req instanceof TableDirtyChangedRequest) {
+			return handleTableDirtyChangedRequest(cfg, req);
+		} else {
+			throw new IllegalArgumentException("Operation not supported");
+		}
+	}
+}
+```

src/main/java/com/untill/driver/interfaces/tables/ITablesHandler.java

@@ -0,0 +1,21 @@
+package com.untill.driver.interfaces.tables;
+
+import com.untill.driver.IDriver;
+import com.untill.driver.interfaces.IDriverInterface;
+import com.untill.driver.params.DriverConfiguration;
+
+/**
+ * Tables handler driver interface
+ *
+ * @see IDriverInterface
+ * @see IDriver
+ */
+public interface ITablesHandler extends IDriverInterface {
+	/**
+	 * Handles table operations
+	 *
+	 * @param cfg driver instance configuration
+	 * @param req request details
+	 */
+	void operation(DriverConfiguration cfg, TableChangedRequest req);
+}

src/main/java/com/untill/driver/interfaces/tables/TableChangedRequest.java

@@ -0,0 +1,38 @@
+package com.untill.driver.interfaces.tables;
+
+import com.untill.driver.interfaces.DriverRequest;
+
+public abstract class TableChangedRequest extends DriverRequest {
+	/**
+	 * Table number
+	 */
+	private int tableNumber;
+	/**
+	 * Table part
+	 */
+	private String tablePart;
+
+	public int getTableNumber() {
+		return tableNumber;
+	}
+
+	public void setTableNumber(int tableNumber) {
+		this.tableNumber = tableNumber;
+	}
+
+	public String getTablePart() {
+		return tablePart;
+	}
+
+	public void setTablePart(String tablePart) {
+		this.tablePart = tablePart;
+	}
+
+	@Override
+	public String toString() {
+		return "TableChangedRequest{"
+				+ "tableNumber=" + tableNumber
+				+ ", tablePart='" + tablePart + '\''
+				+ "} " + super.toString();
+	}
+}

src/main/java/com/untill/driver/interfaces/tables/TableDirtyChangedRequest.java

@@ -0,0 +1,23 @@
+package com.untill.driver.interfaces.tables;
+
+public class TableDirtyChangedRequest extends TableChangedRequest {
+	/**
+	 * The flag is <tt>true</tt> if the <tt>Sales area</tt> setting <tt>Close tables manually</tt> is checked and everything is paid otherwise <tt>false</tt>
+	 */
+	private boolean dirty;
+
+	public boolean isDirty() {
+		return dirty;
+	}
+
+	public void setDirty(boolean dirty) {
+		this.dirty = dirty;
+	}
+
+	@Override
+	public String toString() {
+		return "TableDirtyChangedRequest{"
+				+ "dirty=" + dirty
+				+ "} " + super.toString();
+	}
+}