src/jdk.management.jfr/share/classes/jdk/management/jfr/RecordingInfo.java
author egahlin
Tue, 15 May 2018 20:24:34 +0200
changeset 50113 caf115bb98ad
child 55256 3b22c7e00573
permissions -rw-r--r--
8199712: Flight Recorder Reviewed-by: coleenp, ihse, erikj, dsamersoff, mseledtsov, egahlin, mgronlun Contributed-by: erik.gahlin@oracle.com, markus.gronlund@oracle.com
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
50113
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     1
/*
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     2
 * Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     4
 *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    10
 *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    15
 * accompanied this code).
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    16
 *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    20
 *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    23
 * questions.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    24
 */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    25
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    26
package jdk.management.jfr;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    27
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    28
import java.nio.file.Path;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    29
import java.time.Duration;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    30
import java.time.Instant;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    31
import java.util.LinkedHashMap;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    32
import java.util.List;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    33
import java.util.Map;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    34
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    35
import javax.management.openmbean.CompositeData;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    36
import javax.management.openmbean.TabularData;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    37
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    38
import jdk.jfr.Recording;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    39
import jdk.jfr.RecordingState;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    40
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    41
/**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    42
 * Management representation of a {@code Recording}.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    43
 *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    44
 * @see Recording
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    45
 *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    46
 * @since 9
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    47
 */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    48
public final class RecordingInfo {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    49
    private final long id;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    50
    private final String name;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    51
    private final String state;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    52
    private final boolean dumpOnExit;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    53
    private final long size;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    54
    private final boolean disk;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    55
    private final long maxAge;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    56
    private final long maxSize;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    57
    private final long startTime;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    58
    private final long stopTime;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    59
    private final String destination;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    60
    private final long durationInSeconds;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    61
    private final Map<String, String> settings;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    62
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    63
    // package private
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    64
    RecordingInfo(Recording recording) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    65
        id = recording.getId();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    66
        name = recording.getName();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    67
        state = recording.getState().toString();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    68
        dumpOnExit = recording.getDumpOnExit();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    69
        size = recording.getSize();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    70
        disk = recording.isToDisk();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    71
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    72
        Duration d = recording.getMaxAge();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    73
        if (d == null) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    74
            maxAge = 0;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    75
        } else {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    76
            maxAge = d.getSeconds();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    77
        }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    78
        maxSize = recording.getMaxSize();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    79
        Instant s = recording.getStartTime();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    80
        startTime = s == null ? 0L : s.toEpochMilli();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    81
        Instant st = recording.getStopTime();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    82
        stopTime = st == null ? 0L : st.toEpochMilli();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    83
        Path p = recording.getDestination();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    84
        destination = p == null ? null : p.toString();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    85
        Duration duration = recording.getDuration();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    86
        durationInSeconds = duration == null ? 0 : duration.getSeconds();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    87
        settings = recording.getSettings();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    88
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    89
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    90
    private RecordingInfo(CompositeData cd) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    91
        id = (int) cd.get("id");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    92
        name = (String) cd.get("name");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    93
        state = (String) cd.get("state");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    94
        dumpOnExit = (boolean) cd.get("dumpOnExit");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    95
        size = (long) cd.get("size");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    96
        disk = (boolean) cd.get("disk");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    97
        maxAge = (Long) cd.get("maxAge");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    98
        maxSize = (Long) cd.get("maxSize");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
    99
        startTime = (Long) cd.get("startTime");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   100
        stopTime = (Long) cd.get("stopTime");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   101
        destination = (String) cd.get("destination");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   102
        durationInSeconds = (long) cd.get("duration");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   103
        settings = new LinkedHashMap<>();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   104
        Object map = cd.get("settings");
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   105
        if (map instanceof TabularData) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   106
            TabularData td = (TabularData) map;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   107
            List<String> keyNames = td.getTabularType().getIndexNames();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   108
            int size = keyNames.size();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   109
            for (Object keys : td.keySet()) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   110
                Object[] keyValues = ((List<?>) keys).toArray();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   111
                for (int i = 0; i < size; i++) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   112
                    String key = keyNames.get(i);
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   113
                    Object value = keyValues[i];
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   114
                    if (value instanceof String) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   115
                        settings.put(key, (String) value);
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   116
                    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   117
                }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   118
            }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   119
        }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   120
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   121
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   122
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   123
     * Returns the name of the recording associated with this
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   124
     * {@code RecordingInfo}.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   125
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   126
     * @return the recording name, not {@code null}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   127
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   128
     * @see Recording#getName()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   129
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   130
    public String getName() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   131
        return name;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   132
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   133
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   134
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   135
     * Returns the unique ID for the recording associated with this
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   136
     * {@code RecordingInfo}.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   137
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   138
     * @return the recording ID
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   139
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   140
     * @see Recording#getId()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   141
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   142
    public long getId() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   143
        return id;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   144
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   145
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   146
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   147
     * Returns if the recording associated with this {@code RecordingInfo}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   148
     * should be dumped to file when the JVM exits.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   149
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   150
     * @return {@code true} if recording should be dumped on exit, {@code false}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   151
     *         otherwise
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   152
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   153
     * @see Recording#getDumpOnExit()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   154
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   155
    public boolean getDumpOnExit() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   156
        return dumpOnExit;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   157
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   158
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   159
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   160
     * Returns how many seconds data should be kept on disk, or {@code 0} if
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   161
     * data is to be kept forever.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   162
     * <p>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   163
     * In-memory recordings are not affected by maximum age.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   164
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   165
     * @see Recording#getMaxAge()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   166
     * @see Recording#setToDisk(boolean)
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   167
     * @return how long data should be kept on disk, measured in seconds
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   168
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   169
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   170
    public long getMaxAge() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   171
        return maxAge;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   172
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   173
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   174
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   175
     * Returns the amount of data, measured in bytes, the recording associated
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   176
     * with this {@code RecordingInfo}, should be kept on disk, before it's
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   177
     * rotated away, or {@code 0} if data is to be kept indefinitely.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   178
     * <p>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   179
     * In-memory recordings are not affected by maximum size.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   180
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   181
     * @return the amount of data should be kept on disk, in bytes
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   182
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   183
     * @see Recording#setToDisk(boolean)
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   184
     * @see Recording#getMaxSize()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   185
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   186
    public long getMaxSize() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   187
        return maxSize;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   188
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   189
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   190
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   191
     * Returns a {@code String} representation of state of the recording
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   192
     * associated with this {@code RecordingInfo}.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   193
     * <p>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   194
     * Valid return values are {@code "NEW"}, {@code "DELAYED"}, {@code "STARTING"},
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   195
     * {@code "RUNNING"}, {@code "STOPPING"}, {@code "STOPPED"} and {@code "CLOSED"}.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   196
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   197
     * @return the recording state, not {@code null}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   198
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   199
     * @see RecordingState#toString()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   200
     * @see Recording#getState()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   201
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   202
    public String getState() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   203
        return state;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   204
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   205
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   206
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   207
     * Returns start time of the recording associated with this
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   208
     * {@code RecordingInfo}, measured as ms since epoch, or {@code null} if the
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   209
     * recording hasn't started.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   210
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   211
     * @return the start time of the recording, or {@code null} if the recording
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   212
     *         hasn't started
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   213
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   214
     * @see Recording#getStartTime()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   215
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   216
    public long getStartTime() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   217
        return startTime;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   218
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   219
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   220
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   221
     * Returns the actual or expected stop time of the recording associated with
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   222
     * this {@code RecordingInfo}, measured as ms since epoch, or {@code null}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   223
     * if the expected or actual stop time is not known, which can only happen
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   224
     * if the recording has not yet been stopped.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   225
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   226
     * @return the stop time of recording, or {@code null} if recording hasn't
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   227
     *         been stopped.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   228
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   229
     * @see Recording#getStopTime()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   230
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   231
    public long getStopTime() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   232
        return stopTime;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   233
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   234
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   235
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   236
     * Returns the settings for the recording associated with this
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   237
     * {@code RecordingInfo}.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   238
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   239
     * @return the recording settings, not {@code null}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   240
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   241
     * @see Recording#getSettings()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   242
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   243
    public Map<String, String> getSettings() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   244
        return settings;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   245
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   246
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   247
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   248
     * Returns destination path where data, for the recording associated with
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   249
     * this {@link RecordingInfo}, should be written when the recording stops,
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   250
     * or {@code null} if the recording should not be written.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   251
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   252
     * @return the destination, or {@code null} if not set
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   253
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   254
     * @see Recording#getDestination()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   255
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   256
    public String getDestination() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   257
        return destination;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   258
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   259
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   260
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   261
     * Returns a string description of the recording associated with this
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   262
     * {@code RecordingInfo}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   263
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   264
     * @return description, not {@code null}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   265
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   266
    @Override
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   267
    public String toString() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   268
        Stringifier s = new Stringifier();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   269
        s.add("name", name);
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   270
        s.add("id", id);
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   271
        s.add("maxAge", maxAge);
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   272
        s.add("maxSize", maxSize);
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   273
        return s.toString();
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   274
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   275
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   276
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   277
     * Returns the amount data recorded by recording. associated with this
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   278
     * {@link RecordingInfo}.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   279
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   280
     * @return the amount of recorded data, measured in bytes
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   281
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   282
    public long getSize() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   283
        return size;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   284
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   285
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   286
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   287
     * Returns {@code true} if the recording associated with this
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   288
     * {@code RecordingInfo} should be flushed to disk, when memory buffers are
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   289
     * full, {@code false} otherwise.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   290
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   291
     * @return {@code true} if recording is to disk, {@code false} otherwise
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   292
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   293
    public boolean isToDisk() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   294
        return disk;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   295
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   296
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   297
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   298
     * Returns the desired duration, measured in seconds, of the recording
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   299
     * associated with this {@link RecordingInfo}, or {code 0} if no duration
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   300
     * has been set.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   301
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   302
     * @return the desired duration, or {code 0} if no duration has been set
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   303
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   304
     * @see Recording#getDuration()
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   305
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   306
    public long getDuration() {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   307
        return durationInSeconds;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   308
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   309
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   310
    /**
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   311
     * Returns a {@code RecordingInfo} represented by the specified
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   312
     * {@code CompositeData} object.
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   313
     * <p>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   314
     * The specified {@code CompositeData} must have the following item names and
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   315
     * item types to be valid. <blockquote>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   316
     * <table class="striped">
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   317
     * <caption>Supported names and types in a specified {@code CompositeData} object</caption>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   318
     * <thead>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   319
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   320
     * <th scope="col" style="text-align:left">Name</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   321
     * <th scope="col" style="text-align:left">Type</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   322
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   323
     * </thead>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   324
     * <tbody>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   325
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   326
     * <th scope="row">id</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   327
     * <td>{@code Long}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   328
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   329
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   330
     * <th scope="row">name</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   331
     * <td>{@code String}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   332
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   333
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   334
     * <th scope="row">state</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   335
     * <td>{@code String}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   336
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   337
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   338
     * <th scope="row">dumpOnExit</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   339
     * <td>{@code Boolean}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   340
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   341
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   342
     * <th scope="row">size</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   343
     * <td>{@code Long}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   344
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   345
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   346
     * <th scope="row">disk</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   347
     * <td>{@code Boolean}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   348
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   349
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   350
     * <th scope="row">maxAge</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   351
     * <td>{@code Long}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   352
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   353
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   354
     * <th scope="row">maxSize</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   355
     * <td>{@code Long}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   356
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   357
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   358
     * <th scope="row">startTime</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   359
     * <td>{@code Long}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   360
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   361
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   362
     * <th scope="row">stopTime</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   363
     * <td>{@code Long}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   364
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   365
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   366
     * <th scope="row">destination</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   367
     * <td>{@code String}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   368
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   369
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   370
     * <th scope="row">duration</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   371
     * <td>{@code Long}</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   372
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   373
     * <tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   374
     * <th scope="row">settings</th>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   375
     * <td>{@code javax.management.openmbean.CompositeData[]} whose element type
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   376
     * is the mapped type for {@link SettingDescriptorInfo} as specified in the
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   377
     * {@link SettingDescriptorInfo#from} method.</td>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   378
     * </tr>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   379
     * </tbody>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   380
     * </table>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   381
     * </blockquote>
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   382
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   383
     * @param cd {@code CompositeData} representing the {@code RecordingInfo} to
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   384
     *        return
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   385
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   386
     * @throws IllegalArgumentException if {@code cd} does not represent a valid
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   387
     *         {@code RecordingInfo}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   388
     *
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   389
     * @return the {@code RecordingInfo} represented by {@code cd}, or
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   390
     *         {@code null} if {@code cd} is {@code null}
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   391
     */
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   392
    public static RecordingInfo from(CompositeData cd) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   393
        if (cd == null) {
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   394
            return null;
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   395
        }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   396
        return new RecordingInfo(cd);
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   397
    }
caf115bb98ad 8199712: Flight Recorder
egahlin
parents:
diff changeset
   398
}