com.google.common.flogger.GoogleLoggingApi Maven / Gradle / Ivy
/*
* Copyright (C) 2013 The Flogger Authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.common.flogger;
/**
* Google specific extensions to the fluent logging API.
*
* If a team wishes to implement its own logging extensions, it must extend this API (in the same
* way that this API was extended from LoggingApi) and extend {@link GoogleLogContext} similarly.
* This should all be tied together by implementing an alternate implementation of GoogleLogger.
*
*
However, if you wish to extend the default logging API, please contact flogger-dev@ first.
*
* @param The api returned during method chaining (possibly an extension of this interface).
*/
// NOTE: new methods to this interface should be coordinated with google-java-format
public interface GoogleLoggingApi> extends LoggingApi {
/**
* An implementation of {@link GoogleLoggingApi} which does nothing and discards all parameters.
*/
public static class NoOp> extends LoggingApi.NoOp
implements GoogleLoggingApi {}
}