TailerListenerAdapter.java

  1. /*
  2.  * Licensed to the Apache Software Foundation (ASF) under one or more
  3.  * contributor license agreements.  See the NOTICE file distributed with
  4.  * this work for additional information regarding copyright ownership.
  5.  * The ASF licenses this file to You under the Apache License, Version 2.0
  6.  * (the "License"); you may not use this file except in compliance with
  7.  * the License.  You may obtain a copy of the License at
  8.  *
  9.  *      http://www.apache.org/licenses/LICENSE-2.0
  10.  *
  11.  * Unless required by applicable law or agreed to in writing, software
  12.  * distributed under the License is distributed on an "AS IS" BASIS,
  13.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.  * See the License for the specific language governing permissions and
  15.  * limitations under the License.
  16.  */
  17. package org.apache.commons.io.input;

  18. /**
  19.  * {@link TailerListener} Adapter.
  20.  *
  21.  * @since 2.0
  22.  */
  23. public class TailerListenerAdapter implements TailerListener {

  24.     /**
  25.      * Constructs a new instance.
  26.      */
  27.     public TailerListenerAdapter() {
  28.         // empty
  29.     }

  30.     /**
  31.      * Called each time the Tailer reaches the end of the file.
  32.      *
  33.      * <strong>Note:</strong> this is called from the tailer thread.
  34.      *
  35.      * Note: a future version of commons-io will pull this method up to the TailerListener interface,
  36.      * for now clients must subclass this class to use this feature.
  37.      *
  38.      * @since 2.5
  39.      */
  40.     public void endOfFileReached() {
  41.         // noop
  42.     }

  43.     /**
  44.      * This method is called if the tailed file is not found.
  45.      */
  46.     @Override
  47.     public void fileNotFound() {
  48.         // noop
  49.     }

  50.     /**
  51.      * Called if a file rotation is detected.
  52.      *
  53.      * This method is called before the file is reopened, and fileNotFound may
  54.      * be called if the new file has not yet been created.
  55.      */
  56.     @Override
  57.     public void fileRotated() {
  58.         // noop
  59.     }

  60.     /**
  61.      * Handles an Exception.
  62.      *
  63.      * @param ex the exception.
  64.      */
  65.     @Override
  66.     public void handle(final Exception ex) {
  67.         // noop
  68.     }

  69.     /**
  70.      * Handles a line from a Tailer.
  71.      *
  72.      * @param line the line.
  73.      */
  74.     @Override
  75.     public void handle(final String line) {
  76.         // noop
  77.     }

  78.     /**
  79.      * The tailer will call this method during construction,
  80.      * giving the listener a method of stopping the tailer.
  81.      *
  82.      * @param tailer the tailer.
  83.      */
  84.     @Override
  85.     public void init(final Tailer tailer) {
  86.         // noop
  87.     }
  88. }