Class: ONIX::Reader

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/onix/reader.rb

Overview

This is the primary class for reading data from an ONIX file, and there’s really not much to it

Each file should contain a single header, and 1 or more products:

reader = ONIX::Reader.new("somefile.xml")

puts reader.header.inspect

reader.each do |product|
  puts product.inspect
end

The header will be returned as an ONIX::Header object, and the product will be an ONIX::Product.

The ONIX::Product class can be a bit of a hassle to work with, as data can be nested in it fairly deeply. To wrap all the products returned by the reader in a shim that provides simple accessor access to common attributes, pass the shim class as a second argument

reader = ONIX::Reader.new("somefile.xml", ONIX::APAProduct)

puts reader.header.inspect

reader.each do |product|
  puts product.inspect
end

APAProduct stands for Australian Publishers Association and provides simple access to the ONIX attributes that are commonly used in the Australian market.

As well as accessing the file header, there are handful of other read only attributes that might be useful

reader = ONIX::Reader.new("somefile.xml", ONIX::APAProduct)

puts reader.version
puts reader.xml_lang
puts reader.xml_version
puts reader.encoding

The version attribute is particuarly useful. There are multiple revisions of the ONIX spec, and you may need to handle the file differently based on what version it is.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(input, product_klass = ::ONIX::Product) ⇒ Reader 



58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/onix/reader.rb', line 58

def initialize(input, product_klass = ::ONIX::Product)
  if input.kind_of?(String)
    @reader = LibXML::XML::Reader.file(input)
  elsif input.kind_of?(IO)
    @reader = LibXML::XML::Reader.io(input)
  else
    raise ArgumentError, "Unable to read from file or IO stream"
  end

  @product_klass = product_klass

  @header = read_next

  @xml_lang    ||= @reader.xml_lang
  @xml_version ||= @reader.xml_version.to_f
  @encoding    ||= encoding_const_to_name(@reader.encoding)
end

Instance Attribute Details

#encoding ⇒ Object (readonly)

Returns the value of attribute encoding.



56
57
58
 
# File 'lib/onix/reader.rb', line 56

def encoding
  @encoding
end

#header ⇒ Object (readonly)

Returns the value of attribute header.



56
57
58
 
# File 'lib/onix/reader.rb', line 56

def header
  @header
end

#version ⇒ Object (readonly)

Returns the value of attribute version.



56
57
58
 
# File 'lib/onix/reader.rb', line 56

def version
  @version
end

#xml_lang ⇒ Object (readonly)

Returns the value of attribute xml_lang.



56
57
58
 
# File 'lib/onix/reader.rb', line 56

def xml_lang
  @xml_lang
end

#xml_version ⇒ Object (readonly)

Returns the value of attribute xml_version.



56
57
58
 
# File 'lib/onix/reader.rb', line 56

def xml_version
  @xml_version
end

Instance Method Details

#close ⇒ Object 



84
85
86
 
# File 'lib/onix/reader.rb', line 84

def close
  @reader.close if @reader
end

#each(&block) ⇒ Object

Iterate over all the products in an ONIX file



78
79
80
81
82
 
# File 'lib/onix/reader.rb', line 78

def each(&block)
  while obj = read_next
    yield obj
  end
end