1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
/*
* Copyright (c) 2007-2012, 2015, 2016, 2018 Eike Stepper (Loehne, Germany) and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Eike Stepper - initial API and implementation
*/
package org.eclipse.net4j.util.om;
import org.eclipse.net4j.internal.util.bundle.AbstractPlatform;
import org.eclipse.net4j.util.om.log.OMLogFilter;
import org.eclipse.net4j.util.om.log.OMLogHandler;
import org.eclipse.net4j.util.om.trace.OMTraceHandler;
import java.io.File;
import java.util.Properties;
/**
* Represents the platform that {@link OMBundle bundles} are deployed into, whether OSGi {@link #isOSGiRunning() is
* running} or not.
*
* @author Eike Stepper
* @noextend This interface is not intended to be extended by clients.
* @noimplement This interface is not intended to be implemented by clients.
* @apiviz.landmark
* @apiviz.has {@link OMBundle} bundles platform
* @apiviz.owns {@link org.eclipse.net4j.util.om.log.OMLogHandler} - - logHandlers
* @apiviz.owns {@link org.eclipse.net4j.util.om.trace.OMTraceHandler} - - traceHandlers
* @apiviz.has {@link java.io.File} oneway - - stateFolder
*/
public interface OMPlatform
{
// @Singleton
public static final OMPlatform INSTANCE = AbstractPlatform.createPlatform();
public OMBundle bundle(String bundleID, Class<?> accessor);
public boolean isOSGiRunning();
/**
* @since 2.0
*/
public boolean isExtensionRegistryAvailable();
public boolean isDebugging();
public void setDebugging(boolean debugging);
/**
* @since 3.2
*/
public void addLogFilter(OMLogFilter logFilter);
/**
* @since 3.2
*/
public void removeLogFilter(OMLogFilter logFilter);
public void addLogHandler(OMLogHandler logHandler);
public void removeLogHandler(OMLogHandler logHandler);
public void addTraceHandler(OMTraceHandler traceHandler);
public void removeTraceHandler(OMTraceHandler traceHandler);
public File getStateFolder();
public File getConfigFolder();
public File getConfigFile(String name);
public Properties getConfigProperties(String name);
/**
* @since 3.0
*/
public String getProperty(String key);
/**
* @since 3.0
*/
public String getProperty(String key, String defaultValue);
/**
* @since 3.8
*/
public int getProperty(String key, int defaultValue);
/**
* @since 3.8
*/
public long getProperty(String key, long defaultValue);
/**
* @since 3.8
*/
public <T extends Enum<T>> T getProperty(String key, Class<T> enumType);
/**
* @since 3.8
*/
public <T extends Enum<T>> T getProperty(String key, T defaultValue);
/**
* @since 3.7
*/
public boolean isProperty(String key);
/**
* @since 3.7
*/
public boolean isProperty(String key, boolean defaultValue);
/**
* @since 3.2
*/
public String[] getCommandLineArgs() throws IllegalStateException;
}
|