plugins/org.eclipse.skills/src/org/eclipse/skills/service/ISkillService.java

/*******************************************************************************
 * Copyright (c) 2020 Christian Pontesegger and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v2.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Christian Pontesegger - initial API and implementation
 *******************************************************************************/

package org.eclipse.skills.service;

import org.eclipse.core.runtime.Platform;
import org.eclipse.skills.Activator;
import org.eclipse.skills.model.IUser;

/**
 * Global service to manage user statistics, available quests and skills. To get the service instance use
 *
 * <pre>
 * final ISkillService skillService = PlatformUI.getWorkbench().getService(ISkillService.class);
 * </pre>
 */
public interface ISkillService extends IDataStorage {

	/** Trace enablement for the skills service. */
	boolean TRACE_SKILLS_SERVICE = Activator.getDefault().isDebugging()
			&& "true".equalsIgnoreCase(Platform.getDebugOption("org.eclipse.skills/debug/skillService"));

	String EVENT_BASE = "org/eclipse/skills";

	String EVENT_TASK_STARTED = EVENT_BASE + "/Task/started";
	String EVENT_TASK_COMPLETED = EVENT_BASE + "/Task/completed";

	String EVENT_DEPENDENCY_FULFILLED = EVENT_BASE + "/Dependency/fulfilled";

	String RESOURCE_AVATAR = "avatar.pic";

	IUser getUser();

	/**
	 * Start goal monitors for active tasks.
	 */
	void startUserTasks();

	/**
	 * Start dependency monitors for open tasks.
	 */
	void activateOpenTasks();
}