Sha256: a9ee65a4e644ef55b7f200e7f269b7df14dcbbb968973f5f3c8e2a2a2980f537

Contents?: true

Size: 1.88 KB

Versions: 59

Compression:

Stored size: 1.88 KB

Contents

# encoding: utf-8
require "logstash/event"
require "logstash/plugin"

# This is the base class for logstash codecs.
module LogStash::Codecs; class Base < LogStash::Plugin
  include LogStash::Config::Mixin

  config_name "codec"

  def self.plugin_type
    "codec"
  end

  def initialize(params={})
    super
    config_init(@params)
    register if respond_to?(:register)
    setup_multi_encode!
  end

  public
  def decode(data)
    raise "#{self.class}#decode must be overidden"
  end # def decode

  alias_method :<<, :decode

  public
  # DEPRECATED: Prefer defining encode_sync or multi_encode
  def encode(event)
    encoded = multi_encode([event])
    encoded.each {|event,data| @on_event.call(event,data) }
  end # def encode

  public
  # Relies on the codec being synchronous (which they all are!)
  # We need a better long term design here, but this is an improvement
  # over the current API for shared plugins
  # It is best if the codec implements this directly
  def multi_encode(events)
    if @has_encode_sync
      events.map {|event| [event, self.encode_sync(event)]}
    else
      batch = Thread.current[:logstash_output_codec_batch] ||= []
      batch.clear

      events.each {|event| self.encode(event) }
      batch
    end
  end

  def setup_multi_encode!
    @has_encode_sync = self.methods.include?(:encode_sync)

    on_event do |event, data|
      Thread.current[:logstash_output_codec_batch] << [event, data]
    end
  end

  public
  def close; end;

  # @param block [Proc(event, data)] the callback proc passing the original event and the encoded event
  public
  def on_event(&block)
    @on_event = block
  end

  public
  def flush(&block)
    # does nothing by default.
    # if your codec needs a flush method (like you are spooling things)
    # you must implement this.
  end

  public
  def clone
    return self.class.new(params)
  end
end; end # class LogStash::Codecs::Base

Version data entries

59 entries across 59 versions & 1 rubygems

Version Path
logstash-core-6.8.23-java lib/logstash/codecs/base.rb
logstash-core-6.8.22-java lib/logstash/codecs/base.rb
logstash-core-6.8.21-java lib/logstash/codecs/base.rb
logstash-core-6.8.20-java lib/logstash/codecs/base.rb
logstash-core-6.8.19-java lib/logstash/codecs/base.rb
logstash-core-6.8.18-java lib/logstash/codecs/base.rb
logstash-core-6.8.17-java lib/logstash/codecs/base.rb
logstash-core-6.8.16-java lib/logstash/codecs/base.rb
logstash-core-6.8.15-java lib/logstash/codecs/base.rb
logstash-core-6.8.14-java lib/logstash/codecs/base.rb
logstash-core-6.8.13-java lib/logstash/codecs/base.rb
logstash-core-6.8.12-java lib/logstash/codecs/base.rb
logstash-core-6.8.11-java lib/logstash/codecs/base.rb
logstash-core-6.8.10-java lib/logstash/codecs/base.rb
logstash-core-6.8.9-java lib/logstash/codecs/base.rb
logstash-core-6.8.8-java lib/logstash/codecs/base.rb
logstash-core-6.8.7-java lib/logstash/codecs/base.rb
logstash-core-7.5.2-java lib/logstash/codecs/base.rb
logstash-core-7.5.1-java lib/logstash/codecs/base.rb
logstash-core-6.8.6-java lib/logstash/codecs/base.rb