TargetField = "EmployeeID" NullValue = "-1" />
OPath
Одне з основних завдань при роботі з інформацією - це
створення запитів для вибірки необхідних даних. Так, у випадку РСУБД можна
використовувати мову запитів SQL, для вибірки інформації з XML-джерел у нас
є XPath. Але як SQL, так і XPath - це мови запитів, які занадто
сильно прив'язані до моделі зберігання даних і, як результат, для O/R Mapper
доводиться застосовувати спеціальна мова запитів, який дозволить створювати
запити до даних в термінах об'єктної моделі програми, але легко транслювати
їх у мову, що розуміється сховищем даних (для ObjectSpaces і MS SQL Server це
SQL).
Для звернення до джерела даних в ObjectSpaces
використовується спеціальна мова запитів - OPath. Синтаксис цієї мови
(віддалено він нагадує XPath) дозволяє виконувати запити до джерела даних,
грунтуючись на ієрархії класів, що використовуються в додатку. В даний час
OPath підтримує наступний набір операторів (для операторів може
використовуватися синтаксис як C #, так і VB.NET):
Оператор в C # стилі
Оператор в VB стилі
Опис
.
[]
.
()
Оператори угруповання
використовуються для позначення властивостей і угруповання виразів.
Наприклад: Customer [CustomerID = 'alfki']. Orders.ShipDate> # 11/12/2003 #
!
not
Логічне заперечення. not (Customer [CustomerID = 'alfki'])
*
/
%
*
/
MOD
Множення, ділення,
отримання модуля
+
-
+
-
Додавання, віднімання
<
>
<=
> =
<
>
<=
> =
Порівняння двох
значенійCustomer.CreateDate> # 12/09/2002 #
=
! =
==
=
<>
==
Рівність двох значень
& &
| |
and
or
Customer.Region = 'ru' | | Customer.Region = 'en'
^
^
Символ ^ використовується для
позначень батьків/нащадок. У випадку використання оператора ^ наступні
два вирази еквівалентні: Orders.OrderDetail [^. OrderDate>
# 1/1/2003 #] Orders. [OrderDate> # 1/1/2003 #]
ObjectSpace
При роботі з зберігаються об'єктами нам потрібні
наступні можливості - завантаження збережених об'єктів, відстеження стану і
повернення змін назад, до бази даних. Клас ObjectSpace об'єднує в собі
всі ці можливості. Розглянемо окремі моменти роботи з цим класом.
Створення екземпляра ObjectSpace
Для створення екземпляра ObjectSpace потрібно мати три
схеми - RSD, OSD і MSD (при бажанні їх можна скомбінуйтеовать в одному XML-файлі),
а також примірник SqlConnection для взаємодії з джерелом даних.
// Створення екземпляра класу ObjectSpaces
using (SqlConnection conn = new SqlConnection (
"Data Source = tim;
Integrated Security = SSPI; Database = northwind "))
(
ObjectSpace os = new
ObjectSpace ( "map.xml", conn);
// Працюємо з os. Явно відкривати підключення SqlConnection НЕ
обов'язково.
// Це відбувається автоматично.
)
Запит до джерела даних
Після ініціалізації екземпляра ObjectSpace можна
звернутися до джерела даних. Для цього у класу ObjectSpace є три методи
GetObject, GetObjectReader, GetObjectSet які дозволяють одержувати дані в
вигляді трьох різних форм - одиночний об'єкт, курсор або список.
// Визначимо "зберігаються" об'єкти, які
будемо використовувати надалі
public class Customer
(
public string CustomerID;
public string Name;
public string Company;
public string Phone;
public string Fax;
public ArrayList Orders = new
ArrayList ();
)
public class Order
(
private int _orderID = 0;
public int OrderID
(
get (return _orderID;)
)
public DateTime OrderDate;
public DateTime RequiredDate;
public DateTime ShippedDate;
public Decimal Freight;
public int EmployeeID;
public Customer Customer;
)
// Витягуємо об'єкт
Customer (включаючи підпорядковане властивість Orders)
// на основі OPath-запиту (City = 'Berlin'
& & Orders.OrderDate <# 1998.10.10 #).
// Для кожного примірника
класу Customer завантажується властивість "Orders".
Customer cust = (Customer) os.GetObject (typeof (Customer),
"City = 'Berlin'
& & Orders.OrderDate <# 1998.10.10 # "," Orders ");
У що виливається виклик наведеного вище методу
os.GetObject? Використовуючи Profiler з MS SQL Server, можна побачити, що в БД
буде виконаний наступний SQL-запит (відформатовано для приведення в більш
"Читається" вид):
exec sp_executesql
N'select Customers. [CustomerID],
Customers. [CompanyName],
Customers. [ContactName],
Customers. [City],
Customers. [Phone]
from
[Northwind]. [Dbo]. [Customers] as Customers
where ((Customers. [City]) =
(@ p0))
AND (EXISTS (
select Orders. [OrderID],
Orders. [CustomerID]
from
[Northwind]. [Dbo]. [Orders] as Orders
where ((Customers. [CustomerID])
= (Orders. [CustomerID ]))
AND
((Orders. [OrderDate])> (@ p1))))
order by 1;
select Customers. [CustomerID],
Orders. [OrderID],
Orders. [CustomerID],
Orders. [RequiredDate],
Orders. [ShippedDate],
Orders. [OrderDate]
from
[Northwind]. [Dbo]. [Customers] as Customers,
[Northwind]. [dbo]. [Orders]
as Orders
where (((Customers. [City]) =
(@ p0))
AND (EXISTS (
select Orders. [OrderID],
Orders. [CustomerID]
from
[Northwind]. [Dbo]. [Orders] as Orders
where
((Customers. [CustomerID]) = (Orders. [CustomerID ]))
AND
((Orders. [OrderDate ])>(p1)) )))
AND
((Customers. [CustomerID]) = (Orders. [CustomerID]))
order by 1, 2, 3; ',
N '@ p0 nvarchar (6), @ p1 datetime', @ p0 = N'Berlin ',
@ p1 = 'Oct 10 1998 12:00:00:000 AM'
Створення записів в базі даних
Одне з великих переваг у використанні
ObjectSpaces полягає в тому, що для додавання об'єкту властивостей "зберігання"
його не треба спеціальним чином модифіковані (успадковувати від спеціального базового
класу, спеціальним чином розмічати властивості або поля). Подібна прозорість
реалізації ObjectSpaces дає переваги у використанні.
// Робота з об'єктами
Customer і Orders не залежить
// від того, використовується
ObjectSpaces чи ні
Customer cust = new Customer ();
Order ord = new Order ();
cust.Id = "ALFQI";
cust.Name = "MyName";
cust.Company = "MyCompany";
cust.Phone = "MyPhone";
cust.Fax = "MyFax";
ord.Customer = cust;
ord.OrderDate = DateTime.Now;
ord.ShippedDate = DateTime.Now;
ord.RequiredDate = DateTime.Now;
cust.Orders.Add (ord);
// Перед збереженням
об'єктів необхідно помістити їх в контекст
// ObjectSpaces. Прапор
InitialState.Inserted показує, що ми додаємо нову
// запис в базу даних
os.StartTracking (ord, InitialState.Inserted);
os.StartTracking (cust, InitialState.Inserted);
// Зберігаємо екземпляр класу Customer.
// Параметр
PersistenceOptions (Depth.ObjectGraph) повідомляє,
// що буде збережений весь
граф об'єктів.
os.PersistChanges (cust, new PersistenceOptions (Depth.ObjectGraph ));
Видалення записів з використанням ObjectSpaces
Існуюча версія ObjectSpaces підтримує видалення
об'єктів тільки в тому випадку, якщо вони раніше були додані в контекст
ObjectSpaces.
ПРИМІТКА
Щоб видалити об'єкт з бази даних його
необхідно попередньо додати в контекст ObjectSpaces. Це можна
зробити, використовуючи методи GetObject, GetObjectReader, GetObjectSet класу
ObjectSpace, або додати об'єкт в контекст самостійно за допомогою методу
StartTracking
Customer
cust = new Customer ();
cust.Id
= "ALFQI";
// Перед операцією над об'єктом
необхідно помістити його в контекст
// ObjectSpaces. Прапор
InitialState.Unchanged показує, що об'єкт раніше
// був збережений у базі даних
os.StartTracking (cust,
InitialState.Unchanged);
// Позначає екземпляр класу Customer
як видаляється.
os.MarkForDeletion (cust);
// Зберігаємо зміни в базі даних
os.PersistChanges (cust);
Відкладена завантаження даних
Відкладена завантаження даних - це дуже корисна
можливість, реалізована в ObjectSpaces. Правда, використання цієї
функціональності затьмарюється її недостатньою "прозорістю". Це означає, що в
випадку, коли необхідно довантажувати залежні класи на вимогу, доведеться
модифіковані вихідний код. На щастя, модифікації незначні.
public class Customer
(
public string CustomerID;
public string Name;
public string Company;
public string Phone;
public string Fax;
// Для відкладеної завантаження списку замовлень необхідно перейти
// від використання ArrayList до
використання спеціального класу з
// ObjectSpaces - ObjectList.
public ObjectList Orders = new
ObjectList ();
)
public class Order
(
private int _orderID = 0;
public int OrderID
(
get (return _orderID;)
)
public DateTime OrderDate;
public DateTime RequiredDate;
public DateTime ShippedDate;
public Decimal Freight;
public int EmployeeID;
// Для відкладеної завантаження класу Customer, ми змінюємо тип поля з Customer
// на ObjectHolder. Саме ObjectHolder буде відповідати за підвантаження
потрібних
// даних.
private ObjectHolder _customer
= New ObjectHolder ();
public Customer Customer
(
get (return (Customer)
_customer.InnerObject;)
set (_customer.InnerObject = value;)
)
)
Крім зміни коду програми, відкладену завантаження
властивостей слід оголосити в OSD-схемі. Для цього потрібно додати опис полів
спеціальний атрибут LazyLoad = "true".
Hidden = "false"
Key = "true" Alias = "OrderID" />
Після цього можна працювати з відновленим об'єктом
як завжди:
using (SqlConnection conn = new SqlConnection (
"Data Source = tim;
Integrated Security = SSPI; Database = northwind "))
(
ObjectSpace os = new ObjectSpace ( "map.xml",
conn);
Customer cust =
(Customer) os.GetObject (typeof (Customer),
"CustomerID = 'alfki'");
// Список замовлень завантажиться при першому
зверненні
foreach (Order order in cust.Orders)
(
Console.WriteLine ( "Customer:
(0), OrderDate: (1) ",
order.Customer.Name,
order.OrderDate);
)
)
Метод
Опис
BeginTransaction, Commit,
Rollback
Управління транзакціями.
Варто звернути увагу, що метод Rollback НЕ відкочується зміни в
зберігаються об'єктах, тому можуть виникати ситуації, коли інформація в БД і
інформація, що зберігаються в об'єктах виявляться неузгодженості. Тому, по
уникнути конфліктів, рекомендується після Rollback створювати новий екземпляр
ObjectSpaces.
GetObject
Отримати одиночний об'єкт
заданого типу з бази даних. У параметрах методу можна передати як
OPath-запит, так і список дочірніх об'єктів, які повинні бути завантажені
одночасно з запитуваним об'єктом.
GetObjectReader
Отримати з бази даних
об'єкти через курсор, використовуючи семантику, аналогічну що використовується при роботі
з IDataReader.
GetObjectSet
Отримати об'єкти з БД в
вигляді єдиного масиву. На відміну від ArrayList, клас ObjectSet надає
додаткові можливості відстеження оригінальних значень, передачі
змін через Remoting і деякі інші.
PersistChanges
Зберегти змінений об'єкт
в БД.
MarkForDeletion
Позначити об'єкт для
видалення. Реальне видалення відбувається при виклику PersistChanges.
Resync
Синхронізувати состочніе
об'єкта з інформацією з БД.
StartTracking
"Позначити" об'єкт як зберігається.
Крім поточних значень, у контексті зберігається і стан об'єкта
(новий/змінений/вилучений/без змін)
Додаткові можливості ObjectSpaces
Читання даних з використанням DbObjectReader
В окремих випадках використання класу ObjectSpace
може виявитися надмірним або незручним. Наприклад, якщо для доступу до бази
даних необхідно використовувати процедури, що зберігаються, більша частина
функціональності ObjectSpaces виявиться непотрібною. Але і для подібних ситуацій у
ObjectSpaces є своє рішення. Якщо потрібно витягувати з довільного
джерела даних інформацію у вигляді об'єктів додатка, можна використовувати
клас DbObjectReader. Виступаючи як тонкий прошарок між ADO.NET-курсором
(IDataReader) і класами програми, DbObjectReader дозволяє завантажувати
зберігаються об'єкти з джерел даних, які не підтримуються
ObjectSpaces напряму.
public static void Main ()
(
DataTable table = new
DataTable ();
table.Columns.Add ( "CustomerID",
typeof (int ));
table.Columns.Add ( "CompanyName",
typeof (string ));
table.Columns.Add ( "ContactName",
typeof (string ));
table.Columns.Add ( "Phone",
typeof (string ));
table.Rows.Add (new object [] (
1, "MyCompany", "MyCustomer", "222 33 22" });
using (IDataReader reader =
table.GetDataReader ())
(
DbObjectReader objectReader = new
DbObjectReader (reader,
typeof (Customer), new
MappingSchema ( "map.xml "));
while (objectReader.Read ())
(
Customer cust =
(Customer) objectReader.Current;
Console.WriteLine (cust.Name);
)
)
)
ObjectEngine
Клас ObjectEngine лежить в основі ObjectSpaces і
реалізує механізми взаємодії з джерелом даних. У більшості випадків
ObjectEngine прямо не використовується, але в ситуаціях, коли необхідно
виконати OPath-запит або зберегти об'єкт в БД в обхід основної
функціональності ObjectSpaces і з мінімальними витратами - використання
ObjectEngine може стати в нагоді.
// Невеликий приклад
використання функціональності ObjectEngine
public static void Main ()
(
using (SqlConnection conn = new
SqlConnection (
"Data Source = tim;
Integrated Security = SSPI; Database = northwind "))
(
conn.Open ();
// Враховуючи, що ObjectEngine - це
"Низькорівневий" клас, деяку частину
// підготовчої роботи доводиться
виконувати самостійно.
ObjectContext context =
new CommonObjectContext (new
ObjectSchema ( "osd.xml "));
MappingSchema msd = new
MappingSchema ( "map.xml ");
ObjectSchema osd = new
ObjectSchema ( "osd.xml ");
ObjectSources sources = new
ObjectSources ();
sources.Add ( "NorthwindRSD", conn);
// Створюємо OPath запит і читаємо дані з БД
ObjectExpression expr = OPath.Parse (
new
ObjectQuery (typeof (Customer), "", ""), osd);
// Ще один побічний ефект ObjectEngine - перед використанням OPath
// запит треба "компілювати".
CompiledQuery query = expr.Compile (msd);
Customer cust = null;
// Виконуємо OPath-запит, використовуючи
"Об'єктовий" курсор.
using (ObjectReader reader =
ObjectEngine.GetObjectReader (sources, context, query, new object [] (
}))
(
while (reader.Read ())
(
cust =
(Customer) reader.Current;
Console.WriteLine (cust.Name);
)
)
// Створити об'єкт і зберігаємо його в
джерелі даних
cust = new Customer ();
cust.CustomerID =
"alfq";
cust.Name =
"MyName";
cust.Phone =
"MyPhone";
cust.Company = "MyComp";
context.Add (cust,
ObjectState.Inserted);
ObjectEngine.PersistChanges (msd, sources, context,
new object [] (cust),
PersistenceOptions.Default);
)
)
Розширення ObjectSpaces
Використання декількох XML-схем для опису
структури класів програми, реляційної структури БД, а крім того ще й
Mapping-схеми, що не може не пригнічувати. Звичайно, у фінальній версії. NET Framework
1.2 можливості візуального проектування цих схем повинні обов'язково
з'явитися, але поки їх немає, можна скористатися сторонніми засобами. Одне з
таких засобів входить в приклад ObjectSpacesPDCSamples.zip (фото можна знайти на 
http://www.gotdotnet.com).
До складу цього прикладу входить спеціальна утиліта для
створення всіх необхідних XML-схем (малюнок 4).
Малюнок 4. Microsoft ObjectSpaces Mapper Utility.
Крім цього, в даний приклад входить реалізація класу
ObjectPersistence. Цей клас володіє однією характерною особливістю - він
приховує в собі не тільки створення XML-описів, але і створення необхідної бази
даних. Розглянемо найпростіший приклад використання ObjectPersistence.
using System;
using Microsoft.ObjectSpaces.ObjectPersistence;
class ObjectPersistenceDemo
(
// Вихідний код класу ObjectPersistence також доступний у рамках прикладу
static ObjectPersistence op =
new
ObjectPersistence ( "Data
Source = local; Integrated Security = true; ",
"Persistence ");
static void Main (string [] args)
(
Customer c = new Customer ();
// Шукаємо замовника в базі даних
c = (Customer) op.LoadObject (typeof (Customer),
"CustomerID = 'alfki'");
if (c == null)
(
c = new
Customer ( "alfki ");
c.Comments = "New
Customer ";
)
else
(
c.Comments = "Old
Customer ";
)
// Зберігаємо зміни.
// Якщо база даних/таблиця ще не створені, то це відбудеться зараз
op.Persist (c);
)
)
Клас ObjectPersistence спроектований таким чином,
що для його використання не обов'язково попередньо створювати базу даних,
настроювати XML-схеми даних - все це робиться всередині реалізації
ObjectPersistence. Так, у наведеному вище прикладі на SQL Server буде створена
база даних Persistence, і в неї буде додана таблиця з ім'ям Customer.
Звичайно, не в кожному проекті можна допустити подібні вольності з боку
бібліотеки доступу до даних, але для простих реалізацій - це чудова
можливість приховати непотрібні деталі.
Підсумок
Технології доступу до даних у. NET Framework 1.2
містять безліч корисних нововведень, але якщо для ADO.NET це швидше
еволюційні зміни, пов'язані з простим розширенням бібліотеки, то
ObjectSpaces є абсолютно новим продуктом, який може кардинальним
чином змінити підхід до роботи з даними. Звичайно, в даний момент робота
над бібліотекою ще далека від завершення. До моменту виходу VisualStudio
«Whidbey» ми зможемо побачити в ній багато змін, починаючи з використання
generics і розширення можливостей OPath, і закінчуючи DML-операторами для
видалення об'єктів без попереднього їх вилучення.
Список літератури
Для підготовки даної роботи були використані
матеріали з сайту http://www.rsdn.ru/
