/*
 * Copyright (c) 2013, 2019 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0, which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the
 * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
 * version 2 with the GNU Classpath Exception, which is available at
 * https://www.gnu.org/software/classpath/license.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
 */

package org.glassfish.jersey.server.internal.monitoring;

import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentMap;
import java.util.concurrent.atomic.AtomicReference;

import org.glassfish.jersey.server.model.Resource;
import org.glassfish.jersey.server.model.ResourceMethod;
import org.glassfish.jersey.server.monitoring.ExecutionStatistics;
import org.glassfish.jersey.server.monitoring.ResourceMethodStatistics;
import org.glassfish.jersey.server.monitoring.ResourceStatistics;

Immutable resource statistics implementation.
Author:Miroslav Fuksa, Stepan Vavra
/** * Immutable resource statistics implementation. * * @author Miroslav Fuksa * @author Stepan Vavra */
final class ResourceStatisticsImpl implements ResourceStatistics {
Builder of resource statistics instances.

Must be thread-safe.
/** * Builder of resource statistics instances. * <p/> * Must be thread-safe. */
static class Builder { private final ConcurrentMap<ResourceMethodStatisticsImpl.Builder, Boolean> methodsBuilders = new ConcurrentHashMap<>(); private final ResourceMethodStatisticsImpl.Factory methodFactory; private final AtomicReference<ExecutionStatisticsImpl.Builder> resourceExecutionStatisticsBuilder = new AtomicReference<>(); private final AtomicReference<ExecutionStatisticsImpl.Builder> requestExecutionStatisticsBuilder = new AtomicReference<>(); private volatile ResourceStatisticsImpl cached;
Create a new builder.
Params:
  • resource – Resource for which the instance is created.
/** * Create a new builder. * * @param resource Resource for which the instance is created. */
Builder(final Resource resource, final ResourceMethodStatisticsImpl.Factory methodFactory) { this(methodFactory); for (final ResourceMethod method : resource.getResourceMethods()) { getOrCreate(method); } }
Create a new builder.
/** * Create a new builder. */
Builder(final ResourceMethodStatisticsImpl.Factory methodFactory) { this.methodFactory = methodFactory; }
Build a new instance of ResourceStatisticsImpl.

Note that this build method is called from various different threads.
Returns:New instance of resource statistics.
/** * Build a new instance of {@link ResourceStatisticsImpl}. * <p/> * Note that this build method is called from various different threads. * * @return New instance of resource statistics. */
ResourceStatisticsImpl build() { ResourceStatisticsImpl cachedReference = cached; if (cachedReference != null) { return cachedReference; } final Map<ResourceMethod, ResourceMethodStatistics> resourceMethods = new HashMap<>(); for (final ResourceMethodStatisticsImpl.Builder builder : methodsBuilders.keySet()) { final ResourceMethodStatisticsImpl stats = builder.build(); resourceMethods.put(stats.getResourceMethod(), stats); } final ExecutionStatistics resourceStats = resourceExecutionStatisticsBuilder.get() == null ? ExecutionStatisticsImpl.EMPTY : resourceExecutionStatisticsBuilder.get().build(); final ExecutionStatistics requestStats = requestExecutionStatisticsBuilder.get() == null ? ExecutionStatisticsImpl.EMPTY : requestExecutionStatisticsBuilder.get().build(); final ResourceStatisticsImpl stats = new ResourceStatisticsImpl(resourceMethods, resourceStats, requestStats); if (MonitoringUtils.isCacheable(requestStats)) { cached = stats; } return stats; }
Add execution of a resource method in the resource.
Params:
  • resourceMethod – Resource method executed.
  • methodStartTime – Time of execution of the resource method.
  • methodDuration – Time spent on execution of resource method itself.
  • requestStartTime – Time when the request matching to the executed resource method has been received by Jersey.
  • requestDuration – Time of whole request processing (from receiving the request until writing the response).
/** * Add execution of a resource method in the resource. * * @param resourceMethod Resource method executed. * @param methodStartTime Time of execution of the resource method. * @param methodDuration Time spent on execution of resource method itself. * @param requestStartTime Time when the request matching to the executed resource method has been received by Jersey. * @param requestDuration Time of whole request processing (from receiving the request until writing the response). */
void addExecution(final ResourceMethod resourceMethod, final long methodStartTime, final long methodDuration, final long requestStartTime, final long requestDuration) { cached = null; if (resourceExecutionStatisticsBuilder.get() == null) { resourceExecutionStatisticsBuilder.compareAndSet(null, new ExecutionStatisticsImpl.Builder()); } resourceExecutionStatisticsBuilder.get().addExecution(methodStartTime, methodDuration); if (requestExecutionStatisticsBuilder.get() == null) { requestExecutionStatisticsBuilder.compareAndSet(null, new ExecutionStatisticsImpl.Builder()); } requestExecutionStatisticsBuilder.get().addExecution(requestStartTime, requestDuration); addMethod(resourceMethod); }
Add a resource method to the statistics.
Params:
  • resourceMethod – Resource method.
/** * Add a resource method to the statistics. * * @param resourceMethod Resource method. */
void addMethod(final ResourceMethod resourceMethod) { cached = null; getOrCreate(resourceMethod); } private ResourceMethodStatisticsImpl.Builder getOrCreate(final ResourceMethod resourceMethod) { final ResourceMethodStatisticsImpl.Builder methodStats = methodFactory.getOrCreate(resourceMethod); methodsBuilders.putIfAbsent(methodStats, Boolean.TRUE); return methodStats; } } private final Map<ResourceMethod, ResourceMethodStatistics> resourceMethods; private final ExecutionStatistics resourceExecutionStatistics; private final ExecutionStatistics requestExecutionStatistics; private ResourceStatisticsImpl(final Map<ResourceMethod, ResourceMethodStatistics> resourceMethods, final ExecutionStatistics resourceExecutionStatistics, final ExecutionStatistics requestExecutionStatistics) { this.resourceMethods = Collections.unmodifiableMap(resourceMethods); this.resourceExecutionStatistics = resourceExecutionStatistics; this.requestExecutionStatistics = requestExecutionStatistics; } @Override public ExecutionStatistics getResourceMethodExecutionStatistics() { return resourceExecutionStatistics; } @Override public ExecutionStatistics getRequestExecutionStatistics() { return requestExecutionStatistics; } @Override public Map<ResourceMethod, ResourceMethodStatistics> getResourceMethodStatistics() { return resourceMethods; } @Override public ResourceStatistics snapshot() { // this object is immutable and all the other accessible objects as well return this; } }