1 /*******************************************************************************
2 * Copyright (c) 2014 Ericsson
4 * All rights reserved. This program and the accompanying materials are
5 * made available under the terms of the Eclipse Public License v1.0 which
6 * accompanies this distribution, and is available at
7 * http://www.eclipse.org/legal/epl-v10.html
10 * Alexandre Montplaisir - Initial API and implementation
11 ******************************************************************************/
13 package org
.eclipse
.tracecompass
.statesystem
.core
;
15 import java
.io
.IOException
;
17 import org
.eclipse
.jdt
.annotation
.NonNullByDefault
;
18 import org
.eclipse
.tracecompass
.internal
.statesystem
.core
.StateSystem
;
19 import org
.eclipse
.tracecompass
.statesystem
.core
.backend
.IStateHistoryBackend
;
22 * Factory to create state systems.
24 * Since state system are meant to be accessed using the {@link ITmfStateSystem}
25 * and {@link ITmfStateSystemBuilder} interfaces, you can use this factory to
26 * instantiate new ones.
28 * @author Alexandre Montplaisir
31 public final class StateSystemFactory
{
33 private StateSystemFactory() {}
36 * New-file factory method. For when you build a state system with a new
37 * file, or if the back-end does not require a file on disk.
40 * Back-end plugin to use
41 * @return The new state system
43 public static ITmfStateSystemBuilder
newStateSystem(IStateHistoryBackend backend
) {
44 return new StateSystem(backend
);
48 * General factory method. The backend may try to open or create a file on
49 * disk (the file contents and location are defined by the backend).
52 * The "state history storage" back-end to use.
54 * Put true if this is a new history started from scratch (any
55 * existing file will be overwritten).
56 * @return The new state system
58 * If there was a problem creating the new history file
60 public static ITmfStateSystemBuilder
newStateSystem(IStateHistoryBackend backend
,
61 boolean newFile
) throws IOException
{
62 return new StateSystem(backend
, newFile
);