Module: LogStash::Util::JavaVersion

Defined in:
lib/logstash/util/java_version.rb

Class Method Summary collapse

Class Method Details

.bad_java_version?(version_string) ⇒ Boolean

Determine if the given java version string is a bad version of java If it is, return true, if it isn’t return false. Accepts nil, returning nil.

Returns:

  • (Boolean) 


48
49
50
51
52
53
54
55
56
57
58
59
60
 
# File 'lib/logstash/util/java_version.rb', line 48

def self.bad_java_version?(version_string)
  return nil if version_string.nil?

  parsed = parse_java_version(version_string)

  if parsed[:major] == 1 && parsed[:minor] == 7 && parsed[:patch] == 0 && parsed[:update] < 51
    true
  elsif parsed[:major] == 1 && parsed[:minor] < 7
    true
  else
    false
  end
end

.logger ⇒ Object 



4
5
6
 
# File 'lib/logstash/util/java_version.rb', line 4

def self.logger
  @logger ||= Cabin::Channel.get(LogStash)
end

.parse_java_version(version_string) ⇒ Object

Takes a string of a java version ex: “1.8.0_24-beta” and returns a parsed map of the components. nil inputs will be returned as nil.



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
 
# File 'lib/logstash/util/java_version.rb', line 26

def self.parse_java_version(version_string)
  return nil if version_string.nil?

  # Crazy java versioning rules @ http://www.oracle.com/technetwork/java/javase/versioning-naming-139433.html
  # The regex below parses this all correctly http://rubular.com/r/sInQc3Nc7f

  match = version_string.match(/\A(\d+)\.(\d+)\.(\d+)(_(\d+))?(-(.+))?\Z/)
  major, minor, patch, ufull, update, bfull, build = match.captures

  {
    :full => version_string,
    :major => major.to_i,
    :minor => minor.to_i,
    :patch => patch.to_i,
    :update => update.to_i, # this is always coerced to an int (a nil will be zero) to make comparisons easier
    :build => build # not an integer, could be b06 for instance!,
  }
end

.version ⇒ Object

Return the current java version string. Returns nil if this is a non-java platform (e.g. MRI).



18
19
20
21
 
# File 'lib/logstash/util/java_version.rb', line 18

def self.version
  return nil unless LogStash::Environment.jruby?
  java.lang.System.getProperty("java.runtime.version")
end

.warn_on_bad_java_version ⇒ Object

Print a warning if we’re on a bad version of java



9
10
11
12
13
14
15
 
# File 'lib/logstash/util/java_version.rb', line 9

def self.warn_on_bad_java_version
  if self.bad_java_version?(self.version)
    msg = "!!! Please upgrade your java version, the current version '#{self.version}' may cause problems. We recommend a minimum version of 1.7.0_51"
    STDERR.puts(msg)
    logger.warn(msg)
  end
end