параметр 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
Какая из этих библиотек лучше — дело вкуса. Я рекомендую познакомиться со всеми и сформировать собственное мнение.
