Программирование на языке Ruby

Фултон Хэл

Ниже перечислены методы, определенные в классе

PGlarge

:

• 

open([mode])

открывает BLOB. Аргумент

mode

задает режим работы с объектом, как и в случае с методом

PGconn#loopen

);

• 

close

закрывает BLOB (BLOB'ы также закрываются автоматически, когда их обнаруживает сборщик мусора);

• 

read([length])

пытается прочитать

length

байтов из BLOB'a. Если параметр

length

не задан, читаются все данные;

• 

write(str)

записывает строку в BLOB и возвращает число записанных байтов;

• 

tell

возвращает текущую позицию указателя;

• 

seek(offset, whence)

перемещает указатель в позицию

offset

. Параметр

whence

может принимать значения

SEEK_SET

,

SEEK_CUR

и

SEEK_END

(равные соответственно 0,1,2);

• 

unlink

удаляет BLOB;

• 

oid

возвращает идентификатор BLOB'a;

• 

size

возвращает размер BLOB'a;

• 

export(file)

сохраняет BLOB в файле с указанным именем.

Более интересны методы экземпляра, определенные в классе

PGresult

(перечислены ниже). Объект такого класса возвращается в результате успешного выполнения запроса. (Для экономии памяти вызывайте метод

PGresult#clear

по завершении работы с таким объектом.)

• 

result

возвращает массив кортежей, описывающих результат запроса;

• 

each

— итератор;

• 

[]

— метод доступа;

• 

fields

возвращает массив описаний полей результата запроса;

• 

num_tuples

возвращает число кортежей в результате запроса;

• 

fieldnum(name)

возвращает индекс поля с указанным именем;

• 

type(index)

возвращает целое число, соответствующее типу поля;

• 

size(index)

возвращает размер поля в байтах. 1 означает, что поле имеет переменную длину;

• 

getvalue(tup_num, field_num)

возвращает значение поля с указанным порядковым номером;

tup_num

— номер строки;

• 

getlength(tup_num, field_num)

возвращает длину поля в байтах;

• 

cmdstatus

возвращает строку состояния для последнего запроса;

• 

clear

очищает объект

PGresult

.

10.4.4. Интерфейс с LDAP

Для Ruby есть по меньшей мере три разных библиотеки, позволяющих работать с протоколом LDAP. Ruby/LDAP, написанная Такааки Татеиси (Takaaki Tateishi), — это довольно «тонкая» обертка. Если вы хорошо знакомы с LDAP, то ее может оказаться достаточно; в противном случае вы, наверное, сочтете ее слишком сложной. Пример:

conn = LDAP::Conn.new("rsads02.foo.com")

conn.bind("CN=username,CN=Users,DC=foo,DC=com", "password") do |bound|

 bound.search("DC=foo,DC=com", LDAP::LDAP_SCOPE_SUBTREE,

"(&(name=*) (objectCategory=person))", ['name','ipPhone'])

 do |user|

puts "#{user['name']} #{user['ipPhone']}"

 end

end

Библиотека

ActiveLDAP

организована по образцу

ActiveRecord

. Вот пример ее использования, взятый с домашней страницы:

require 'activeldap'

require 'examples/objects/user'

require 'password'

# Установить соединение Ruby/ActiveLDAP и т. д.

ActiveLDAP::Base.connect(:password_block

 => Proc.new { Password.get('Password: ') },

:allow_anonymous => false)

# Загрузить запись с данными о пользователе

# (ее класс определен в примерах).

wad = User.new('wad')

# Напечатать общее имя.

р wad.cn

# Изменить общее имя.

wad.cn = "Will"

# Сохранить в LDAP.

wad.write

Есть также сравнительно недавняя библиотека, написанная Фрэнсисом Чианфрокка (Francis Cianfrocca), многие предпочитают именно ее:

require 'net/ldap'

ldap = Net::LDAP.new :host => server_ip_address,

 :port => 389,

 :auth => {

:method => :simple,

:username => "cn=manager,dc=example,dc=com",

:password => "opensesame"

 }

filter = Net::LDAP::Filter.eq( "cn", "George*" )

treebase = "dc=example,dc=com"

ldap.search( :base => treebase, :filter => filter ) do |entry|

 puts "DN: #{entry.dn}"

 entry.each do |attribute, values|

puts " #{attribute}:"

values.each do |value|

puts " --->#{value}"

end

 end

end

p ldap.get_operation_result

Какая из этих библиотек лучше — дело вкуса. Я рекомендую познакомиться со всеми и сформировать собственное мнение.