Oracle Database 12c Release 1
Available for download! Linux/Solaris only, as always...
Why Oracle will be always first?
Появился Oracle 11g ODAC and Oracle Developer Tools for Visual Studio.
Состав:
Тяжело работать с людьми, которые сами не знают, чего хотят. Еще хуже, если эти люди являются заказчиками
программного обеспечения. Они требуют за копейки кнопку "Сделать все". А потом еще чуть-чуть. И я уже не первый раз
наблюдаю эту ситуацию. А самое веселое, когда дело доходит до отчетов. Мы хотим, чтобы был дизайнер. А еще мы
хотим, чтобы все было попроще. А еще мы не знаем, что это будут за отчеты, так что сделайте универсальное
решение.
И ломай потом голову.
Я считаю, что дизайнер стоит кучу денег, для его написания нужен не один человеко-год. И пока что не видел ни одного универсального решения, с которым пользователь ощущал бы себя не обезьяной. Наиболее приемлемый вариант - вбивать логику построения отчета в программу. Дешево и сердито! Ну, дальше изложу один из вариантов такого решения.
Для получения отчета нужно:
Строки, числа, даты необходимые для построения отчета.
Набор правил построения отчета.
Механизм, преобразующий данные по правилам.
В самом сложном варианте эти компоненты создаются индивидуально для каждого отчета. Но, лучше, конечно, по-максимуму автоматизировать каждую часть и их взаимодействие. В идеале, шаблон редактируется с помощью developer-friendly designer, процессор является универсальным готовым решением, а данные представляют собой расширяемый формат, в который можно положить любые данные.
Итак, данные в формате XML преобразуются XSLT процессором в выходной файл.
Altova StyleVision является нашим самым главным фигурантом и помощником, он же developer-friendly designer. Это визуальный редактор, который позволяет получить на выходе XSLT 2.0 файл, преобразующий XML в HTML, RTF или PDF!
Я уже точно не помню, зачем понадобился именно XSLT 2.0, вероятно из-за каких-то фич дизайнера, но вот найти бесплатный процессор для Java было напряжно. Из коммерческих есть Oracle XML Developer's Kit, из некоммерческих - Saxon. Других не нашел! С .NET ситуация хуже, под него только Saxon. Ну, Saxon так Saxon!
Исходные данные получаем из источника данных (БД, например) и формируем XML файл с определенной схемой, которая описывается в XSD. Механизм формирования не имеет значения, но, если данные качаются из БД, я бы предпочел возложить этот процесс на сервер (далее в примере я буду получать от любимой СУБД Oracle сразу XML, а если поднатужиться, то и файл с отчетом можно получить!).
Я буду использовать существующую схему SH (Sales History). Как ее установить написано здесь.
Итак, наш отчет будет выдавать некую информацию о клиенте - имя, фамилия, пол, дата рождения и т.д. StyleVision
хочет видеть XSD схему документов, которые прийдется использовать в качестве данных. Схему можно создавать либо
вручную, подгоняя потом под нее XML, либо построить по существующему XML. Все это, кстати умеет делать Altova XMLSpy.
Вот моя схема (Customer.xsd
):
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:simpleType name="T_Valid"> <xs:restriction base="xs:string"> <xs:enumeration value="I"/> <xs:enumeration value="A"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="T_Gender"> <xs:restriction base="xs:string"> <xs:enumeration value="M"/> <xs:enumeration value="F"/> </xs:restriction> </xs:simpleType> <xs:complexType name="T_Customer"> <xs:sequence> <xs:element ref="FirstName"/> <xs:element ref="LastName"/> <xs:element ref="Gender"/> <xs:element ref="YearOfBirth"/> <xs:element ref="Address"/> <xs:element ref="Valid"/> </xs:sequence> </xs:complexType> <xs:complexType name="T_Address"> <xs:sequence> <xs:element ref="Street"/> <xs:element ref="PostalCode"/> <xs:element ref="City"/> <xs:element ref="StateProvince"/> <xs:element ref="Country"/> </xs:sequence> </xs:complexType> <xs:element name="YearOfBirth" type="xs:short"/> <xs:element name="Valid" type="T_Valid"/> <xs:element name="Street" type="xs:string"/> <xs:element name="StateProvince" type="xs:string"/> <xs:element name="PostalCode" type="xs:int"/> <xs:element name="LastName" type="xs:string"/> <xs:element name="Gender" type="T_Gender"/> <xs:element name="FirstName" type="xs:string"/> <xs:element name="Customer" type="T_Customer"/> <xs:element name="Country" type="xs:string"/> <xs:element name="City" type="xs:string"/> <xs:element name="Address" type="T_Address"/> </xs:schema>
Соответственно, Oracle SQL запрос (в SQL Server этот запрос был бы на пару страниц неразбираемого текста):
SELECT XMLElement("Customer", XMLElement("FirstName", c.cust_first_name), XMLElement("LastName", c.cust_last_name), XMLElement("Gender", c.cust_gender), XMLElement("YearOfBirth", c.cust_year_of_birth), XMLElement("Address", XMLElement("Street", c.cust_street_address), XMLElement("PostalCode", c.cust_postal_code), XMLElement("City", c.cust_city), XMLElement("StateProvince", c.cust_state_province), XMLElement("Country", (SELECT country_name FROM sh.countries WHERE country_id = c.country_id) ) ), XMLElement("Valid", c.cust_valid)) AS DATA FROM sh.customers c WHERE c.cust_id = 43228
Вместо 43228, конечно, нужно сделать bindable переменную, но мне лень.
И его результат (Customer.xml
):
<Customer> <FirstName>Abner</FirstName> <LastName>Everett</LastName> <Gender>M</Gender> <YearOfBirth>1957</YearOfBirth> <Address> <Street>117 West Gloucester Avenue</Street> <PostalCode>72059</PostalCode> <City>Los Angeles</City> <StateProvince>CA</StateProvince> <Country>United States of America</Country> </Address> <Valid>I</Valid> </Customer>
File -> New -> New from XML Schema / DTD..., указать путь к XSD файлу и желательно предоставить ему сразу файл-пример с данными, соответствующий этой схеме, конечно же.
После окончания создания шаблона (template.sps
) нужно его сохранить в XSLT
(transform-rtf.xslt
): File -> Save Generated Files -> Save Generated XSLT-RTF File....
The Saxon package is a collection of tools for processing XML documents. The main components are:
Saxon implements XSLT 2.0, XPath 2.0, and XQuery 1.0 as defined in the final Recommendations of 23 January 2007. It also includes an implementation of the XML Schema 1.0 Recommendation.
Full details of Saxon's conformance to the specifications are provided in the Conformance section.
In addition, Saxon provides an extensive library of extensions, all implemented in conformance with the XSLT and XQuery Recommendations to ensure that portable stylesheets and queries can be written. These include the EXSLT extension libraries common, sets, math, and dates-and-times. Many of these extensions were pioneered in Saxon and have since become available in other products.
These extension functions are in general accessible from XQuery and XPath as well as XSLT, except where they depend on stylesheet information. Some extensions are available in Saxon-SA only.
Библиотека Saxon позволяет компилировать
XSLT файл:
The term
compileis stretching a point. The executable that is produced does not contain machine instructions, or even interpreted Java bytecode. It contains instructions in the form of a data structure that Saxon itself can interpret. Note that the format of compiled stylesheets is unlikely to be stable from one Saxon release to the next.
Можно, конечно, не компилировать, но я предпочитаю прятать исходники шаблона (в т.ч. из лицензионных соображений). Кстати, из-за этого на моей прошлой работе разработчику прийдется все переделывать с нуля - файлы шаблона и схемы безвозвратно утеряны с моим уходом (злобный смешок). Команда компиляции выглядит так:
java -cp d:\Development\Libs\Java\Saxon.v9\saxon9.jar net.sf.saxon.Compile transform-rtf.xslt transform-rtf.saxon
transform-rtf.xslt
- входной файл, transform-rtf.saxon
- выходной.
Все просто - подключение к БД, выполнение запроса, получение потока XML, загрузка скомпилированного шаблона, создание трансформера и преобразование XML в RTF.
0: /** 1: * 2: */ 3: package com.chabster.reporting.app; 4: 5: import java.io.File; 6: import java.io.InputStream; 7: import java.sql.Connection; 8: import java.sql.DriverManager; 9: 10: import javax.xml.transform.*; 11: import javax.xml.transform.stream.StreamResult; 12: import javax.xml.transform.stream.StreamSource; 13: 14: import net.sf.saxon.Configuration; 15: import net.sf.saxon.PreparedStylesheet; 16: import oracle.jdbc.OraclePreparedStatement; 17: import oracle.jdbc.OracleResultSet; 18: import oracle.jdbc.driver.OracleDriver; 19: import oracle.sql.OPAQUE; 20: 21: /** 22: * @author Chabster 23: */ 24: public class Startup 25: { 26: 27: static String query = "SELECT XMLElement(\"Customer\",\r\n" + 28: " XMLElement(\"FirstName\", c.cust_first_name),\r\n" + 29: " XMLElement(\"LastName\", c.cust_last_name),\r\n" + 30: " XMLElement(\"Gender\", c.cust_gender),\r\n" + 31: " XMLElement(\"YearOfBirth\", c.cust_year_of_birth),\r\n" + 32: " XMLElement(\"Address\",\r\n" + 33: " XMLElement(\"Street\", c.cust_street_address),\r\n" + 34: " XMLElement(\"PostalCode\", c.cust_postal_code),\r\n" + 35: " XMLElement(\"City\", c.cust_city),\r\n" + 36: " XMLElement(\"StateProvince\", c.cust_state_province),\r\n" + 37: " XMLElement(\"Country\",\r\n" + 38: " (SELECT country_name FROM sh.countries WHERE country_id = c.country_id)\r\n" + 39: " )\r\n" + 40: " ),\r\n" + 41: " XMLElement(\"Valid\", c.cust_valid)) AS DATA\r\n" + 42: " FROM sh.customers c\r\n" + 43: " WHERE c.cust_id = 43228"; 44: 45: public static void main(String[] args) { 46: try { 47: DriverManager.registerDriver(new OracleDriver()); 48: 49: Connection conn = DriverManager.getConnection("jdbc:oracle:thin:chabster/***@localhost:1521/MAIN"); 50: OraclePreparedStatement preparedStmt = (OraclePreparedStatement) conn.prepareStatement(query); 51: 52: OracleResultSet oraRS = (OracleResultSet) preparedStmt.executeQuery(); 53: oraRS.next(); 54: OPAQUE xmlObj = oraRS.getOPAQUE(1); 55: Configuration configuration = new Configuration(); 56: InputStream xmlStream = xmlObj.getStream(); 57: 58: PreparedStylesheet preparedStylesheet = PreparedStylesheet.loadCompiledStylesheet(configuration, "transform-rtf.saxon"); 59: 60: Transformer transformer = preparedStylesheet.newTransformer(); 61: File outputFile = new File("out.rtf"); 62: Source xmlSource = new StreamSource(xmlStream); 63: Result output = new StreamResult(outputFile); 64: 65: transformer.transform(xmlSource, output); 66: 67: xmlStream.close(); 68: oraRS.close(); 69: preparedStmt.close(); 70: conn.close(); 71: } 72: catch (Exception ex) { 73: ex.printStackTrace(); 74: } 75: } 76: }
Механизм прост и удобен для разработчика. Генерация файлов происходит быстро, поддерживаются основные форматы документов - HTML, RTF и PDF. Правда, есть и свои нюансы, связанные с ограниченными возможностями дизайнера Altova StyleVision. Например, если в отчет нужно вставить картинку из БД, то прийдется это писать частично вручную. Также минимальный размер генерируемого файла - 46 Kb! Плюс вечно плавающие стандарты W3C и отсутствие библиотек, которые их поддерживают.
SQL> @YOUR_PATH\demo\schema\mksample.sql passwd_system passwd_sys pw_hr pw_oe pw_pm pw_ix pw_sh pw_bi users temp x:\path\to\log\with\trailing\slash\
SQL> @d:\Oracle\Db\11.1.0\db0\demo\schema\mksample.sql sys_passwd sys_passwd hr_passwd oe_passwd pm_passwd ix_passwd sh_passwd bi_passwd users temp c:\temp\
CREATE TABLE sales_transactions_ext ( PROD_ID NUMBER, CUST_ID NUMBER, TIME_ID DATE, CHANNEL_ID NUMBER, PROMO_ID NUMBER, QUANTITY_SOLD NUMBER, AMOUNT_SOLD NUMBER(10,2), UNIT_COST NUMBER(10,2), UNIT_PRICE NUMBER(10,2) ) ORGANIZATION external ( TYPE oracle_loader DEFAULT DIRECTORY data_file_dir ACCESS PARAMETERS ( RECORDS DELIMITED BY NEWLINE CHARACTERSET US7ASCII TERRITORYМожно заменить все точки на запятые или вписать територию с нужным форматом дробных чисел. Я использовал первый вариант.AMERICANBADFILE log_file_dir:'ext_1v3.bad' LOGFILE log_file_dir:'ext_1v3.log' FIELDS TERMINATED BY "|" OPTIONALLY ENCLOSED BY '^' LDRTRIM ( PROD_ID , CUST_ID , TIME_ID DATE(10) "YYYY-MM-DD", CHANNEL_ID , PROMO_ID , QUANTITY_SOLD , AMOUNT_SOLD , UNIT_COST , UNIT_PRICE ) ) LOCATION ('sale1v3.dat') ) REJECT LIMIT 100;
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
This is site maintained by the Puget Sound Oracle Users Group. |