Class: Ezid::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/ezid/client.rb

Overview

EZID client

Constant Summary collapse

VERSION =

ezid-client gem version (e.g., “0.8.0”)

File.read(File.expand_path("../../../VERSION", __FILE__)).chomp.freeze
API_VERSION =

EZID API version

"2".freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(opts = {}) ⇒ Client

Returns a new instance of Client.



49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/ezid/client.rb', line 49

def initialize(opts = {})
  @host = opts[:host] || config.host
  @port = (opts[:port] || config.port).to_i
  @use_ssl = opts[:use_ssl] || config.use_ssl
  @timeout = (opts[:timeout] || config.timeout).to_i
  @user = opts[:user] || config.user
  @password = opts[:password] || config.password
  if block_given?
    
    yield self
    logout
  end
end

Instance Attribute Details

#host ⇒ Object (readonly) 



47
48
49
 
# File 'lib/ezid/client.rb', line 47

def host
  @host
end

#password ⇒ Object (readonly) 



47
48
49
 
# File 'lib/ezid/client.rb', line 47

def password
  @password
end

#port ⇒ Object (readonly) 



47
48
49
 
# File 'lib/ezid/client.rb', line 47

def port
  @port
end

#timeout ⇒ Object (readonly) 



47
48
49
 
# File 'lib/ezid/client.rb', line 47

def timeout
  @timeout
end

#use_ssl ⇒ Object (readonly) 



47
48
49
 
# File 'lib/ezid/client.rb', line 47

def use_ssl
  @use_ssl
end

#user ⇒ Object (readonly) 



47
48
49
 
# File 'lib/ezid/client.rb', line 47

def user
  @user
end

Class Method Details

.config ⇒ Object

Configuration reader



30
31
32
 
# File 'lib/ezid/client.rb', line 30

def config
  @config ||= Configuration.new
end

.configure {|the| ... } ⇒ Object

Yields the configuration to a block

Yield Parameters:



36
37
38
 
# File 'lib/ezid/client.rb', line 36

def configure
  yield config
end

.version ⇒ String

Verbose version string

Returns:

  • (String) —

    the version



42
43
44
 
# File 'lib/ezid/client.rb', line 42

def version
  "ezid-client #{VERSION} (EZID API Version #{API_VERSION})"
end

Instance Method Details

#batch_download(params = {}) ⇒ Object

Submit a batch download request

Parameters:

  • format (String) —

    format of results - one of “anvl”, “csv”, “xml”

  • params (Hash) (defaults to: {}) —

    optional request parameters

See Also:



179
180
181
 
# File 'lib/ezid/client.rb', line 179

def batch_download(params={})
  execute BatchDownloadRequest, params
end

#config ⇒ Ezid::Configuration

The client configuration

Returns:



70
71
72
 
# File 'lib/ezid/client.rb', line 70

def config
  self.class.config
end

#connection ⇒ Net::HTTP

The Net::HTTP object used to connect to EZID

Returns:

  • (Net::HTTP) —

    the connection



185
186
187
 
# File 'lib/ezid/client.rb', line 185

def connection
  @connection ||= build_connection
end

#create_identifier(identifier, metadata = nil) ⇒ Ezid::Response

Create an identifier (PUT an existing identifier)

Parameters:

  • identifier (String) —

    the identifier string to create

  • metadata (String, Hash, Ezid::Metadata) (defaults to: nil) —

    optional metadata to set

Returns:

Raises:

See Also:



122
123
124
 
# File 'lib/ezid/client.rb', line 122

def create_identifier(identifier, metadata=nil)
  execute CreateIdentifierRequest, identifier, metadata
end

#delete_identifier(identifier) ⇒ Ezid::Response

Delete an identifier (only reserved identifier can be deleted)

Parameters:

  • identifier (String) —

    the identifier to delete

Returns:

Raises:

See Also:



162
163
164
 
# File 'lib/ezid/client.rb', line 162

def delete_identifier(identifier)
  execute DeleteIdentifierRequest, identifier
end

#get_identifier_metadata(identifier) ⇒ Ezid::Response

Get the metadata for an identifier

Parameters:

  • identifier (String) —

    the identifier to retrieve

Returns:

Raises:

See Also:



153
154
155
 
# File 'lib/ezid/client.rb', line 153

def get_identifier_metadata(identifier)
  execute GetIdentifierMetadataRequest, identifier
end

#inspect ⇒ Object 



63
64
65
66
 
# File 'lib/ezid/client.rb', line 63

def inspect
  "#<#{self.class.name} connection=#{connection.inspect}, " \
    "user=#{user.inspect}, session=#{logged_in? ? 'OPEN' : 'CLOSED'}>"
end

#logged_in? ⇒ true, false

Returns whether the client is logged in.

Returns:

  • (true, false) —

    whether the client is logged in



112
113
114
 
# File 'lib/ezid/client.rb', line 112

def logged_in?
  session.open?
end

#logger ⇒ Logger

The client logger

Returns:

  • (Logger) —

    the logger



76
77
78
 
# File 'lib/ezid/client.rb', line 76

def logger
  @logger ||= config.logger
end

#login ⇒ Ezid::Client

Open a session

Returns:

Raises:



89
90
91
92
93
94
95
96
97
 
# File 'lib/ezid/client.rb', line 89

def 
  if logged_in?
    logger.info("Already logged in, skipping login request.")
  else
    response = execute LoginRequest
    session.open(response.cookie)
  end
  self
end

#logout ⇒ Ezid::Client

Close the session

Returns:



101
102
103
104
105
106
107
108
109
 
# File 'lib/ezid/client.rb', line 101

def logout
  if logged_in?
    execute LogoutRequest
    session.close
  else
    logger.info("Not logged in, skipping logout request.")
  end
  self
end

#mint_identifier(shoulder = nil, metadata = nil) ⇒ Ezid::Response

Mint an identifier

Parameters:

  • shoulder (String) (defaults to: nil) —

    the shoulder on which to mint a new identifier

  • metadata (String, Hash, Ezid::Metadata) (defaults to: nil) —

    metadata to set

Returns:

Raises:

See Also:



132
133
134
135
136
 
# File 'lib/ezid/client.rb', line 132

def mint_identifier(shoulder=nil, metadata=nil)
  shoulder ||= config.default_shoulder
  raise Error, "Shoulder missing -- cannot mint identifier." unless shoulder
  execute MintIdentifierRequest, shoulder, metadata
end

#modify_identifier(identifier, metadata) ⇒ Ezid::Response

Modify an identifier

Parameters:

  • identifier (String) —

    the identifier to modify

  • metadata (String, Hash, Ezid::Metadata) —

    metadata to set

Returns:

Raises:

See Also:



144
145
146
 
# File 'lib/ezid/client.rb', line 144

def modify_identifier(identifier, metadata)
  execute ModifyIdentifierRequest, identifier, metadata
end

#server_status(*subsystems) ⇒ Ezid::StatusResponse

Get the EZID server status (and the status of one or more subsystems)

Parameters:

  • subsystems (Array)

Returns:

  • (Ezid::StatusResponse) —

    the status response

Raises:

See Also:



171
172
173
 
# File 'lib/ezid/client.rb', line 171

def server_status(*subsystems)
  execute ServerStatusRequest, *subsystems
end

#session ⇒ Ezid::Session

The client session

Returns:



82
83
84
 
# File 'lib/ezid/client.rb', line 82

def session
  @session ||= Session.new
end