Программирование на языке Ruby, Фултон Хэл

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

на обложку

Фултон Хэл

Шрифт:

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

PGlarge

•

open([mode])

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

mode

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

PGconn#loopen

);

•

закрывает 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

Библиотека

ActiveLDAP

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

ActiveRecord

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