Service exceptions externalized and better logging configuration

Signed-off-by: Rogiel <rogiel@rogiel.com>

src/main/java/com/l2jserver/service/game/character/CharacterService.java

@@ -0,0 +1,155 @@
+/*
+ * This file is part of l2jserver <l2jserver.com>.
+ *
+ * l2jserver is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * l2jserver is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with l2jserver.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package com.l2jserver.service.game.character;
+
+import com.l2jserver.model.world.L2Character;
+import com.l2jserver.model.world.capability.Actor;
+import com.l2jserver.service.Service;
+import com.l2jserver.service.game.spawn.AlreadySpawnedServiceException;
+import com.l2jserver.service.game.spawn.NotSpawnedServiceException;
+import com.l2jserver.service.game.spawn.SpawnPointNotFoundServiceException;
+import com.l2jserver.util.dimensional.Coordinate;
+import com.l2jserver.util.dimensional.Point;
+
+/**
+ * This service manages {@link L2Character} instances
+ * 
+ * @author <a href="http://www.rogiel.com">Rogiel</a>
+ */
+public interface CharacterService extends Service {
+	/**
+	 * Perform all operations required to this character join the world
+	 * 
+	 * @param character
+	 *            the character
+	 * @throws SpawnPointNotFoundServiceException
+	 *             if the character does not have an spawn point defined
+	 * @throws AlreadySpawnedServiceException
+	 *             if the character is already spawned in the world
+	 */
+	void enterWorld(L2Character character)
+			throws SpawnPointNotFoundServiceException,
+			AlreadySpawnedServiceException;
+
+	/**
+	 * Perform all operations required to this character leave the world
+	 * 
+	 * @param character
+	 *            the character
+	 * @throws NotSpawnedServiceException
+	 *             if the object is not spawned in the world
+	 */
+	void leaveWorld(L2Character character) throws NotSpawnedServiceException;
+
+	/**
+	 * Set the target of this <tt>character</tt>
+	 * 
+	 * @param character
+	 *            the character
+	 * @param actor
+	 *            the targeted actor
+	 * @throws CannotSetTargetServiceException
+	 *             if target cannot be set
+	 */
+	void target(L2Character character, Actor actor)
+			throws CannotSetTargetServiceException;
+
+	/**
+	 * Attacks with the given <tt>character</tt> the <tt>target</tt>
+	 * 
+	 * @param character
+	 *            the character
+	 * @param target
+	 *            the target
+	 * @throws CannotSetTargetServiceException
+	 *             if target cannot be set
+	 */
+	void attack(L2Character character, Actor target)
+			throws CannotSetTargetServiceException;
+
+	/**
+	 * Jails the given <tt>character</tt> for <tt>time</tt> seconds.
+	 * 
+	 * @param character
+	 *            the character
+	 * @param time
+	 *            the jail time, in seconds
+	 * @param reason
+	 *            the jail reason
+	 * @throws CharacterInJailServiceException
+	 *             if the character is already in jail
+	 */
+	void jail(L2Character character, long time, String reason)
+			throws CharacterInJailServiceException;
+
+	/**
+	 * Unjails the given <tt>character</tt>
+	 * 
+	 * @param character
+	 *            the character to be unjailed
+	 * @throws CharacterNotInJailServiceException
+	 *             if character is not in jail
+	 */
+	void unjail(L2Character character)
+			throws CharacterNotInJailServiceException;
+
+	/**
+	 * Moves the given <tt>character</tt> to <tt>coordinate</tt>
+	 * 
+	 * @param character
+	 *            the character
+	 * @param coordinate
+	 *            the coordinate
+	 */
+	void move(L2Character character, Coordinate coordinate);
+
+	/**
+	 * Validates the position of an character
+	 * 
+	 * @param character
+	 *            the character
+	 * @param point
+	 *            the validated point
+	 */
+	void validate(L2Character character, Point point);
+
+	/**
+	 * Called when received the validation of the position of an character
+	 * 
+	 * @param character
+	 *            the character
+	 * @param point
+	 *            the validated point
+	 */
+	void receivedValidation(L2Character character, Point point);
+
+	/**
+	 * Set the character to walking mode
+	 * 
+	 * @param character
+	 *            the character
+	 */
+	void walk(L2Character character);
+
+	/**
+	 * Set the character to run mode
+	 * 
+	 * @param character
+	 *            the character
+	 */
+	void run(L2Character character);
+}