[core] Rename "receive()" to "willReceive()".

close #409

Signed-off-by: Stéphane Galland <galland@arakhne.org>

eclipse-sarl/plugins/io.sarl.core/src/io/sarl/core/bic.sarl

@@ -419,9 +419,30 @@ capacity DefaultContextInteractions {
 	* ...
 	* MyAgent.spawn(mySpawnArgs).receive(new StartWorkingEvent)
 	* </code>
+	*
+	* @Deprecated see #willReceive(UUID, Event)
 	*/
+	@Deprecated
 	def receive(receiver : UUID, e : Event)
 
+	/**
+	* Inverse signature of send. Useful to send events using the agent's UUID.
+	* Example:
+	*  If you need to send an event to a newly created agent you should usually do :
+	* <code>
+	* ...
+	* const mySpawnArgs = ...
+	* const myAgentAddr = MyAgent.spawn(mySpawnArgs)
+	* defaultSpace.emit(new StartWorkingEvent, AddressScope::scope(myAgentAddr)
+	* </code> 
+	* <p>The equivalent using receive could be written:
+	* <code>
+	* ...
+	* MyAgent.spawn(mySpawnArgs).willReceive(new StartWorkingEvent)
+	* </code>
+	*/
+	def willReceive(receiver : UUID, e : Event)
+
 	/** Replies if the given space is the default space of the default context.
 	 *
 	 * @param space - the space to test.

sre/io.janusproject/io.janusproject.plugin/src/io/janusproject/kernel/bic/DefaultContextInteractionsSkill.java

@@ -108,8 +108,17 @@ public EventSpace getDefaultSpace() {
 		return this.defaultSpace;
 	}
 
+	/** {@inheritDoc}
+	 * @deprecated see {@link #willReceive(UUID, Event)}
+	 */
+	@Deprecated
 	@Override
 	public void receive(UUID receiverID, Event event) {
+		willReceive(receiverID, event);
+	}
+
+	@Override
+	public void willReceive(UUID receiverID, Event event) {
 		final Address recAddr = this.defaultSpace.getAddress(receiverID);
 		this.emit(event, Scopes.addresses(recAddr));
 	}