Introduced sending objects without the usage of a packet, as Hydra handles that internally with a StandardPacket class. Therefore reworked the examples and provided explanations for the usage. Also added javadoc for the new introduced methods. Bumped to version 1.5.0.

Author: marcluque

README.md

@@ -36,7 +36,7 @@ like a [simple chat application](https://github.com/DataSecs/Hydra/wiki/Building
 <dependency>
     <groupId>de.datasecs</groupId>
     <artifactId>hydra-all</artifactId>
-    <version>1.4.7</version>
+    <version>1.5.0</version>
 </dependency>
 ```
 
@@ -46,7 +46,7 @@ like a [simple chat application](https://github.com/DataSecs/Hydra/wiki/Building
 <dependency>
     <groupId>de.datasecs</groupId>
     <artifactId>hydra-all</artifactId>
-    <version>1.4.5</version>
+    <version>1.5.0</version>
 </dependency>
 ```
 

all/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>hydra</artifactId>
         <groupId>de.datasecs</groupId>
-        <version>1.4.7</version>
+        <version>1.5.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -16,14 +16,14 @@
         <dependency>
             <groupId>de.datasecs</groupId>
             <artifactId>hydra-client</artifactId>
-            <version>1.4.7</version>
+            <version>1.5.0</version>
         </dependency>
 
         <!-- Hydra server -->
         <dependency>
             <groupId>de.datasecs</groupId>
             <artifactId>hydra-server</artifactId>
-            <version>1.4.7</version>
+            <version>1.5.0</version>
         </dependency>
     </dependencies>
 

client/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>hydra</artifactId>
         <groupId>de.datasecs</groupId>
-        <version>1.4.7</version>
+        <version>1.5.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -16,7 +16,7 @@
         <dependency>
             <groupId>de.datasecs</groupId>
             <artifactId>hydra-shared</artifactId>
-            <version>1.4.7</version>
+            <version>1.5.0</version>
         </dependency>
     </dependencies>
 

client/src/main/java/de/datasecs/hydra/client/HydraClient.java

@@ -9,6 +9,7 @@
 import io.netty.channel.Channel;
 import io.netty.channel.EventLoopGroup;
 
+import java.io.Serializable;
 import java.net.SocketAddress;
 
 /**
@@ -94,6 +95,19 @@ public void send(Packet packet) {
         clientSession.send(packet);
     }
 
+    /**
+     * Sends a packet to the opponent that is connected with this session. With the difference that the param not is a
+     * packet. The packet is created internally and then send to the opponent, so the user doesn't have to bother with
+     * the packet creation. Therefore the object that is passed to the method has to be serializable.
+     * See {@link de.datasecs.hydra.shared.protocol.packets.StandardPacket} for the structure of the standard packet.
+     *
+     * @param object the object that is supposed to be send to the opponent of the session.
+     */
+    public <T extends Serializable> void send(T object) {
+        checkChannel();
+        clientSession.send(object);
+    }
+
     /**
      * Returns the channel (a connection/pipeline) that was created for the server. The channel allows a lot of functionality.
      * The channel provides information about the channel configuration, the channel state, the channel pipeline and much

client/src/test/java/client/ExampleClient.java

@@ -57,6 +57,12 @@ public void onDisconnected(Session session) {
         session.send(new SamplePacket("This is a message", new String[]{"This", "is", "a", "message"}));
         // Sends a list, that is converted to a Object and the array, like above
         session.send(new SamplePacket(Arrays.asList("This", "is", "a", "message", "2"), new String[]{"This", "is", "a", "message", "2"}));
+        /* Sends an object the user wants to send with the limitation that the object has to be serializable.
+         * Hydra internally uses a standard packet that comes ready out of the box. The only thing that is important to notice
+         * is the fact, that the Handler for the packet still has to be created by the user itself. Therefore see
+         * the SamplePacketListener of the server example classes.
+         */
+        session.send("This is a String and dealt with as object by Hydra");
 
         // Closes the connection and releases all occupied resources
         //client.close();

pom.xml

@@ -7,7 +7,7 @@
     <groupId>de.datasecs</groupId>
     <artifactId>hydra</artifactId>
     <packaging>pom</packaging>
-    <version>1.4.7</version>
+    <version>1.5.0</version>
 
     <modules>
         <module>all</module>

server/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>hydra</artifactId>
         <groupId>de.datasecs</groupId>
-        <version>1.4.7</version>
+        <version>1.5.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -16,7 +16,7 @@
         <dependency>
             <groupId>de.datasecs</groupId>
             <artifactId>hydra-shared</artifactId>
-            <version>1.4.7</version>
+            <version>1.5.0</version>
         </dependency>
     </dependencies>
 

server/src/test/java/server/SamplePacketListener.java

@@ -1,6 +1,7 @@
 package server;
 
 import de.datasecs.hydra.shared.handler.Session;
+import de.datasecs.hydra.shared.protocol.packets.StandardPacket;
 import de.datasecs.hydra.shared.protocol.packets.listener.HydraPacketListener;
 import de.datasecs.hydra.shared.protocol.packets.listener.PacketHandler;
 import server.packets.SamplePacket;
@@ -52,4 +53,14 @@ public void onSampleSerializationPacket(SampleSerializationPacket sampleSerializ
         session.close();
         System.out.println("\nSession closed!");
     }
+
+    @PacketHandler
+    public void onStandardPacket(StandardPacket standardPacket, Session session) {
+        System.out.println("\n---PACKET-LISTENER OUTPUT---");
+
+        System.out.printf("Received from client using the StandardPacket: %s%n", standardPacket);
+
+        session.close();
+        System.out.println("\nSession closed!");
+    }
 }

shared/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>hydra</artifactId>
         <groupId>de.datasecs</groupId>
-        <version>1.4.7</version>
+        <version>1.5.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 

shared/src/main/java/de/datasecs/hydra/shared/handler/HydraSession.java

@@ -2,10 +2,12 @@
 
 import de.datasecs.hydra.shared.protocol.HydraProtocol;
 import de.datasecs.hydra.shared.protocol.packets.Packet;
+import de.datasecs.hydra.shared.protocol.packets.StandardPacket;
 import io.netty.channel.Channel;
 import io.netty.channel.ChannelHandlerContext;
 import io.netty.channel.SimpleChannelInboundHandler;
 
+import java.io.Serializable;
 import java.net.SocketAddress;
 
 /**
@@ -43,6 +45,11 @@ public void send(Packet packet) {
         channel.writeAndFlush(packet);
     }
 
+    @Override
+    public <T extends Serializable> void send(T object) {
+        channel.writeAndFlush(new StandardPacket(object));
+    }
+
     @Override
     public void close() {
         channel.disconnect();