Merge branch 'release-1.0.2'

project/Build.scala

@@ -4,10 +4,10 @@ import sbt.Keys._
 object Build extends sbt.Build
 {
 	val main = Project( "communicator", file( "." ) ).settings(
-		name := "Communicator",
-		organization := "com.taig.communicator",
-		version := "1.0.1",
+		name := "android-communicator",
+		organization := "com.taig",
+		version := "1.0.2",
 		autoScalaLibrary := false,
-		libraryDependencies += "com.google.android" % "android" % "4.3" % "provided" from ( "file://" + System.getenv( "ANDROID_HOME" ) + "/platforms/android-18/android.jar" )
+		libraryDependencies += "com.google.android" % "android" % "4.4" % "provided" from ( "file://" + System.getenv( "ANDROID_HOME" ) + "/platforms/android-19/android.jar" )
 	)
 }

src/main/java/com/taig/communicator/event/Event.java

@@ -77,6 +77,16 @@ protected void onCancel( InterruptedIOException exception )
 		//
 	}
 
+	/**
+	 * Triggers only once, right before the actual sending process starts.
+	 * 
+	 * @param total The total amount of bytes to send or <code>-1</code> if unknown.
+	 */
+	protected void onSend( long total )
+	{
+		//
+	}
+
 	/**
 	 * Triggers every time the {@link Request Request's} {@link OutputStream} sends an {@link Stream.Output#update()}.
 	 *
@@ -103,6 +113,16 @@ protected void onSend( int progress )
 		//
 	}
 
+	/**
+	 * Triggers only once, right before the actual sending process starts.
+	 *
+	 * @param total The total amount of bytes to receive or <code>-1</code> if unknown.
+	 */
+	protected void onReceive( long total )
+	{
+		//
+	}
+
 	/**
 	 * Triggers every time the {@link Request Request's} {@link InputStream} sends an {@link Stream.Input#update()}.
 	 * <p/>
@@ -286,6 +306,7 @@ public void run()
 					if( current == 0 )
 					{
 						onEvent( State.SEND );
+						onSend( total );
 					}
 
 					onSend( current, total );
@@ -308,6 +329,7 @@ public void run()
 					if( current == 0 )
 					{
 						onEvent( State.RECEIVE );
+						onReceive( total );
 					}
 
 					onReceive( current, total );