25 |
25 |
26 package java.util.logging; |
26 package java.util.logging; |
27 |
27 |
28 |
28 |
29 /** |
29 /** |
30 * The management interface for the logging facility. It is recommended |
30 * The management interface for the logging facility. |
31 * to use the {@link java.lang.management.PlatformLoggingMXBean} management |
|
32 * interface that implements all attributes defined in this |
|
33 * {@code LoggingMXBean}. The |
|
34 * {@link java.lang.management.ManagementFactory#getPlatformMXBean(Class) |
|
35 * ManagementFactory.getPlatformMXBean} method can be used to obtain |
|
36 * the {@code PlatformLoggingMXBean} object representing the management |
|
37 * interface for logging. |
|
38 * |
31 * |
39 * <p>There is a single global instance of the {@code LoggingMXBean}. |
32 * {@link java.lang.management.PlatformLoggingMXBean |
40 * This instance is an {@link javax.management.MXBean MXBean} that |
33 * java.lang.management.PlatformLoggingMXBean} is the management interface |
41 * can be obtained by calling the {@link LogManager#getLoggingMXBean} |
34 * for logging facility registered in the {@link |
42 * method or from the |
35 * java.lang.management.ManagementFactory#getPlatformMBeanServer() |
43 * {@linkplain java.lang.management.ManagementFactory#getPlatformMBeanServer |
|
44 * platform MBeanServer}. |
36 * platform MBeanServer}. |
45 * <p> |
37 * It is recommended to use the {@code PlatformLoggingMXBean} obtained via |
46 * The {@link javax.management.ObjectName ObjectName} that uniquely identifies |
38 * the {@link java.lang.management.ManagementFactory#getPlatformMXBean(Class) |
47 * the management interface for logging within the {@code MBeanServer} is: |
39 * ManagementFactory.getPlatformMXBean(PlatformLoggingMXBean.class)} method. |
48 * <pre> |
40 * |
49 * {@link LogManager#LOGGING_MXBEAN_NAME java.util.logging:type=Logging} |
41 * @deprecated {@code LoggingMXBean} is no longer a {@link |
50 * </pre> |
42 * java.lang.management.PlatformManagedObject platform MXBean} and is replaced |
51 * <p> |
43 * with {@link java.lang.management.PlatformLoggingMXBean}. |
52 * The instance registered in the platform {@code MBeanServer} |
44 * It will not register in the platform {@code MBeanServer}. |
53 * is also a {@link java.lang.management.PlatformLoggingMXBean}. |
45 * Use {@code ManagementFactory.getPlatformMXBean(PlatformLoggingMXBean.class)} |
|
46 * instead. |
54 * |
47 * |
55 * @author Ron Mann |
48 * @author Ron Mann |
56 * @author Mandy Chung |
49 * @author Mandy Chung |
57 * @since 1.5 |
50 * @since 1.5 |
58 * |
51 * |
59 * @see java.lang.management.PlatformLoggingMXBean |
52 * @see java.lang.management.PlatformLoggingMXBean |
60 */ |
53 */ |
|
54 @Deprecated(since="9") |
61 public interface LoggingMXBean { |
55 public interface LoggingMXBean { |
62 |
56 |
63 /** |
57 /** |
64 * Returns the list of currently registered logger names. This method |
58 * Returns the list of currently registered logger names. This method |
65 * calls {@link LogManager#getLoggerNames} and returns a list |
59 * calls {@link LogManager#getLoggerNames} and returns a list |