فکر میکنم این مقاله به دردتون بخوره من خودم 2 تا کار با این روش انجام دادم
توليد مکانيزه صفحات استاتيک به کمک XML
اکنون روش مورد نظر در اين مقاله را بررسی می‌کنيم. در اين روش به جای اينکه يک صفحه ديناميک از جنس ASP يا ASP.NET بسازيم که محتوای هر خبر يا مقاله را نمايش بدهد، يک صفحه Template از جنس XSL می‌سازيم و محل قرارگرفتن داده‌های فيلدهای هر رکورد را داخل صفحه مشخص می‌کنيم. برای ساختن صفحات Template مذکور بايد ابتدا صفحات وب را به فرمت XHTML تبديل کنيم. سپس با قراردادن فيلدهای موردنظر، صفحه XHTML را به XSL تبديل کنيم.
تبديل HTML به XHTML
ساختن صفحات XHTML بسيار ساده است. کافی است صفحه معمولی خود را بسازيد و محل قرارگرفتن فيلدها را مشخص کنيد (مثلا از طريق تايپ کردن نام هر فيلد) و سپس به کمک يک مبدل HTML به XHTML صفحه وب خود را به فرمت سازگار با XHTML تبديل کنيد. برنامه‌ای مانند Dreamweaver به کمک يک فرمان ساده، اين کار را به راحتی آب خوردن انجام می‌دهد!
تفاوت يک HTML معمولی با يک HTML سازگار با فرمت XHTML چندان زياد نيست. درواقع کنترلی بايد روی صفحه انجام شود تا مطمئن شويم که tagهای صفحه در قياس با قواعد XML اصطلاحا well-form هستند. مثلا در فرمت XML هر tag که شروع میشود بايد حتما پايانی داشته باشد. مثل <table></table> اگر بعضی از tag ها قرار است که تنها باشند (مثل <br>) اين tag ها بايد به صورت مثلا </br> اصلاح شوند. چند تغيير جزئی ديگر نيز بايد صورت گيرد تا صفحه کاملا با فرمت XHTML سازگار باشد. حتی اگر يک کاراکتر هم ناسازگار با قواعد XML باشد، امکان استفاده از روش توضيح داده شده در اين مقاله وجود نخواهد داشت. ضمنا، کلاس و شئ XML در دات‌نت بعضی از کاراکترها و ترکيب‌های کاراکتری را نيز نمی‌پذيرد. مثلا ;nbsp& که نمايانگر يک space يا فاصله است، از ديد مفسر XML در دات نت مجاز نيست و به جايش بايد همان کاراکتر space را تايپ کنيد. نگران نباشيد. محدوديت‌هايی که در اين زمينه وجود دارند بسيار اندک هستند و تقربيا صفحه خود را با حدود يکی دو درصد تغيير می‌توانيد به يک XHTML قابل استفاده برای کلاس XML تبديل کنيد.
يادآوری مهم : ضروری است که صفحات فارسی خود را از جنس يونی‌کد و با کاراکترست utf-8 بسازيد. زيرا شئ xml در دات نت تنها در اين صورت می‌تواند اطلاعات فارسی را بدون مشکل پردازش کند.
تبديل XHTML به XSL
اين قسمت از کار مهمترين قسمت ساختن Template مورد نظر است. برای اينکار بايد با استاندارد XSL و تکنيک‌ها و زبان آن آشنا شويد. XSL بحث مفصلی دارد و برای آموختن آن کتاب‌های متعددی چاپ شده است که لازم است حداقل يکی از آنها را به عنوان مرجع دم دست داشته باشيد. من برای سهولت کار، چند تکنيک ساده و پرکاربرد XSL را که در اين مقاله نياز داريم، داخل فايل مثالی که ضميمه مقاله است، پياده کرده‌ام که می‌توانيد از آنها به عنوان الگو استفاده کنيد. XSL به معنی eXtensible Stylesheet Language است. XSL در دنيای فناوری XML مشابه CSS در دنيای HTML است. اگر با CSS ها آشنايی داشته باشيد، درک کاری که XSL انجام می‌دهد چندان برايتان مشکل نخواهد بود. همانطور که از CSS برای فرم دادن به صفحات وب استفاده می‌کنيم، از XSL نيز برای فرم دادن به محتويات فايلهای XML استفاده می‌کنيم.
تکنيک‌هايی که برای پردازش فايلهای XSL و قراردادن داده‌های XML استفاده میشود اصطلاحا XSLT نام دارد (به انتهای عبارت XSL کلمه Transformation را بيفزاييد).
قلب فرآيندی که اتفاق می‌افتد به اين شرح است :
- داده‌های شما، يعنی اطلاعات رکوردهای خبر و مقاله بايد به فرمت XML درآيند.
- کد برنامه، فايل XSL شما را باز می‌کند و آن را برای يافتن tag های مخصوص نمايش فيلدهای اطلاعاتی جستجو می‌کند و به محض پيدا کردن محل فيلد، اطلاعات آن را جايگزين می‌کند.
به عنوان مثال عبارت <"xsl:value-of select="ArticleTitle> معادل گزينه‌ای است که چند پاراگراف بالاتر به عنوان روش نمايش فيلد ArticleTitle در صفحه ASP.NET شرح دادم. به عنوان نمونه ديگر، در زبان XSL با استفاده از syntax زير می‌توانيم يک حلقه بسازيم :
<xsl:for-each select="//Table">
...
</xsl:for-each>
که حلقه روی فيلدهای جدول Table تکرار میشود.
کاری که ما در برنامه خود انجام می‌دهيم اينست که ابتدا رکوردهای بانک اطلاعاتی را با استفاده از شئ xml در دات نت به XML تبديل می‌کنيم سپس با استفاده از کلاس xslt يک فايل XSL را بازميکنيم و داده ها را درون آن ميريزيم و حاصل را به صورت يک HTML معمولی ذخيره می‌کنيم. همين!
کد برنامه توليد مکانيزه صفحات وب با استفاده از ASP.NET
کاری که ما بايد انجام دهيد اينست که يک صفحه ASP.NET بسازيم که عمليات توليد صفحه استاتيک را به طور خودکار انجام دهد تا بتوانيم حاصل فرآيند را خيلی ساده روی سايت publish کنيم. البته می‌توانيم ASP.NET را طوری بنويسيم که خودش در محل مشخص شده توسط ما صفحات HTML توليد شده را save کند. در اينصورت بايد ميزبان شما قابليت استفاده از فناوری ASP.NET را در اختيار شما قرار دهد وگرنه مجبوريد صفحات را روی دستگاه خودتان توليد کنيد و بعد حاصل کار را به صورت دستی يا به هر روش ديگر upload کنيد.
و حالا سورس کد :
( من از VB.NET استفاده کرده ام ولی خودتان می‌دانيد که چقدر تبديل آن به #C آسان است)
۱- برای اجرای برنامه لازم است کلاسهای مورد نياز را import کنيم :
Imports System.Text
Imports System.Data
Imports System.Data.SqlClient
Imports System.IO
Imports System.IO.Path
Imports System.Xml
Imports System.Xml.Xsl
۲- من فرض را براين میگذارم که شما يک datagrid خودتان ساخته‌ايد و می توانيد در اين صفحه ASP.NET رکوردهای اخبار و مقالاتتان را مديريت کنيد. من در اين مقاله روش اينکار را توضيح نمی‌دهم چون روشش خيلی آسان و سرراست است و در همه سايت‌های مربوط به ASP.NET ميتوانيد يک دوجين مقاله درباره روش نمايش رکوردهای بانک اطلاعاتی توسط datagrid پيدا کنيد. شما بايد همچنين در اين datagrid امکان select کردن يک رکورد (جهت انجام پردازشها مورد نياز اين مقاله) را اضافه کنيد. اين کار نيز آسان است و من قصد آموزش آن در اينجا را ندارم.
۳- همه عمليات را يک تابع بسيار ساده و جادويی انجام می‌دهد :-)
Function GenerateOneHTML(ByVal RecordID As Integer) As Boolean
'single node-----------------------
Dim myData As DataSet = GetDataSet()
Dim doc As XmlDataDocument = New XmlDataDocument(myData)
Dim FileName As String
Dim ln As Integer
Dim node As XmlElement = doc.DocumentElement.SelectSingleNode("//Table[ID=" + RecordID.ToString + "]")
If Not node Is Nothing Then
Dim doc2 As XmlDocument = New XmlDocument
doc2.LoadXml(node.OuterXml)
'Generate HTML file name
FileName = RecordID.ToString
Dim HTMLsPath As String = Server.MapPath("\") + "Articles\" + Trim(doc2.SelectSingleNode("//Category").InnerText) + "\"
'Transform
Dim xslt As XslTransform = New XslTransform
xslt.Load(HTMLsPath + "temp.html")
Dim writer As XmlTextWriter = New XmlTextWriter(HTMLsPath + FileName + ".htm", System.Text.Encoding.UTF8)
'writer.Formatting = Formatting.Indented
'writer.Indentation = 2
xslt.Transform(doc2, Nothing, writer, Nothing)
writer.Close()
End If
Return True
End Function
از جزئيات اين تابع نترسيد. خيلی ساده در سه مرحله، يعنی در سه سوت (!) کار را تمام می‌کند.
من اين تابع را بعد از يک ماه تلاش مداوم به اين صورت خلاصه و مفيد نوشتم و خيالتان راحت باشد که صد در صد کار می‌کند. فقط توجه کنيد که نام فيلدهای استفاده شده در اين تابع با توجه به نامگذاری فيلدهای پايگاه داده خودم صورت گرفته است و شما بايد اين جزئيات تابع را مطابق نياز خود تغيير دهيد. مراحل سه گانه فوق به اين شرح هستند :
۱- خواندن xml از روی dataset
۲- توليد نام فايل خروجی
۳- تبديل (Tarnsform)
سومين مرحله که مهترين مرحله است، درواقع همان عمليات XSLT است. در اينجا بايد گفت دست طراحان معماری دات نت درد نکند که با چهار خط کد می‌توان يک فرآيند XSLT را کامل کرد!
مرحله اول :
در اين مرحله از روی dataset يک xml می‌سازيم :
'single node-----------------------
Dim myData As DataSet = GetDataSet()
Dim doc As XmlDataDocument = New XmlDataDocument(myData)
Dim FileName As String
Dim ln As Integer
Dim node As XmlElement = doc.DocumentElement.SelectSingleNode("//Table[ID=" + RecordID.ToString + "]")
توجه کنيد که من روش ساختن dataset را توضيح نداده‌ام ولی شما خودتان می‌توانيد تابع GetDataSet را مطابق نيازتان بنويسيد. اين کار يکی از آسان‌ترين و ابتدايی ترين روشهای کار با رابط برنامه‌نويسی ADO.NET است (لابد می‌دانيد که دو روش عمده برای خواندن اطلاعات از بانک اطلاعاتی وجود دارد، يکی شئ DataReader و ديگری شئ DataSet) و من در اينجا برای اجتناب از طولانی شدن مقاله، از توضيح دادن آن صرف‌نظر کردم.
شئ جادوئی XmlDataDocument کارش تبديل dataset به XML است. خط آخر اين مرحله يک شئ XmlElement از روی همان رکوردی که می‌خواهيم اطلاعاتش را بخوانيم می‌سازد. دقت کنيد که چطوری نام جدول پايگاه داده و id رکورد را که به صورت input وارد تابع کرده‌ام، به اين شئ خورانده میشود.
مرحله دوم :
حالا بايد از روی خروجی xml شئ مذکور يعنی node.OuterXml يک شئ XmlDocument بسازيم و dataset را کنار بگذاريم (توجه کنيد که در سورس اصلی تابعی که نوشته‌ام، مرحله دوم و سوم را داخل يک شرط if قرار داده‌ام تا اگر رکورد مورد نظر پوچ بود اين دو مرحله اجرا نشوند):
Dim doc2 As XmlDocument = New XmlDocument
doc2.LoadXml(node.OuterXml)
'Generate HTML file name
FileName = RecordID.ToString
Dim HTMLsPath As String = Server.MapPath("\") + "Articles\" + Trim(doc2.SelectSingleNode("//Category").InnerText) + "\"
در واقع يک XmlDocument در کد برنامه دات نت، معرف يک xml است. و در تمام اين مقاله هرجا گفتم کلاس (يا شئ xml در دات نت) بيشتر مقصودم همين شئ بود. البته کل اشياء بکار رفته در اين مقاله از کلاس مادر System.xml و System.xml.xsl مشتق شده اند.
در ادامه اين مرحله من کمی با اطلاعات فيلد RecordID بازی کرده ام تا يک نام دلخواه و يک path مناسب برای دخيره کردن فايل HTML نهايی جور کنم. همچنين اگر خواستيد روی داده‌های رکورد مورد نظر، پيش از قرارگرفتن در XSL تغييری انجام دهيد، مثلا تاريخ ميلادی را به شمسی تبديل کنيد، جايش همين مرحله است. با استفاده از syntax زير می‌توانيد به محتويات يک فيلد از اين رکورد دسترسی داشته باشيد (قابل خواندن و نوشتن):
doc2.SelectSingleNode("//FieldName").InnerText
مرحله سوم :
در اين مرحله عمليات جادويی تبديل صورت می‌گيرد!
خط اول يک XslTransform معرفی کرده ام. اين شئ يک تابع بدقلق اما فوق‌العاده نيرومند دارد که حدود ده تا تعريف overload دارد. يعنی می‌توان اين تابع را به چندين روش فراخوانی کرد. پيدا کردن حالت مناسب برای اين تابع خودش مکافاتی بود (!) ولی حالا نتيجه کار بسيار ساده از آب درآمده است. من فايل XSL که به روش توضيح داده شده ساختم را به اسم temp.html در همان مسيری (path) که می‌خواهم فايل خروجی را ذخيره کنم قرار دادم. ابتدا با استفاده از تابع load اين فايل را باز میکنم. سپس با استفاده از يک شئ جادويی ديگر به نام XmlTextWriter يک مجرای خروجی (يک stream) برای تابع Transform فراهم میکنم:
'Transform
Dim xslt As XslTransform = New XslTransform
xslt.Load(HTMLsPath + "temp.html")
Dim writer As XmlTextWriter = New XmlTextWriter(HTMLsPath + FileName + ".htm", System.Text.Encoding.UTF8)
'writer.Formatting = Formatting.Indented
'writer.Indentation = 2
xslt.Transform(doc2, Nothing, writer, Nothing)
writer.Close()
ذکر چند نکته در اينجا ضروری است:
۱- آدرسی که در مرحله دوم ساختم را به XmlTextWriter می‌دهم.
۲- فرمت يونی‌کد را نيز برای XmlTextWriter مشخص میکنم.
۳- اگر دلم خواست، از property فرمتينگ نيز استفاده میکنم:
writer.Formatting = Formatting.Indented
writer.Indentation = 2
اين property خيلی جالب و در عين حال دردسرساز است. کارش اينست که خروجی HTML شما را برای خواندن سورس آن فرم بدهد. اگر اينکار را نکنيد، XmlTextWriter تمام فايل HTML شما را در يک خط (!) می‌نويسد. هنگام نمايش HTML هيچ اتفاق يا مشکل خاصی پيش نمی‌آيد اما اگر برويد روی مرورگر گزينه view source را بزنيد متوجه میشود که خواندن اين فايل واقعا مکافات است!
Property فوق اين مشکل را برطرف می‌کند و خروجی HTML را طوری توليد می‌کند که بشود سورس آن را (مثل آدم!) خواند. فقط اشکالش اينست که در برخی Layout ها به دليل انداختن يک سری space اضافه، صفحه را از ريخت می‌اندازد. در مورد سايت من چنين مشکلی پيش آمد و من بيخيال فرمتينگ شدم. Property دوم که Indentation نام دارد ميزان تاثير گذاری فرمتينگ را مشخص می‌کند. عدد 2 نرمال است. اگر بيشتر بدهيد، nesting سورس HTML را بيشتر می‌کند، خودتان امتحان کنيد، متوجه خواهيد شد.
سرانجام فرمان آسمانی Transform انجام میشود. همه مقاله را به خاطر اين تابع پرتشريفات نوشتم. میخواستم از اول بگويم اين تابع چه تابع خوبی است، توی رودربايستی افتادم و اين مقاله را نوشتم!
فراموش نکنيد که مجرای XmlTextWriter را بايد پس از اتمام کار بست. حالا اگر به پوشه‌ای که می‌خواستيد فايلتان آنجا ذخيره شود مراجعه کنيد می‌بينيد که يک صفحه وب تر و تميز حاوی مقاله يا خبر شما آنجا نشسته و اسم دلخواه شما را نيز به خود گرفته است (در اينجا همان کد id).
بايد datagrid خودتان را طوری بسازيد که بشود از طريق يک checkbox کنار هر رکورد، آنهايی که مايليد صفحه خبر يا مقاله‌اش را بسازيد، مشخص کرد. سپس يکی يکی id اين رکوردها را به تابع مورد بحث می‌دهيد تا به ازای هرکدام از آنها يک صفحه بسازد. توجه کنيد که تکرار اجرای اين فرمان روی يک رکورد موجب overwrite شدن فايل قبلی میشود. يعنی می‌توانيد به سادگی فايل را update کنيد.
اگر خواستيد Layout سايت تان را تغيير دهيد، کافی است فايل XSL خود را يکبار دستکاری کنيد. اينکار خيلی ساده است. اگر XSL را با پسوند htm يا html ذخيره کنيد، برنامه‌ای مانند Dreamweaver آن را مانند يک صفحه وب معمولی باز می‌کند تا بتوانيد ويرايشش کنيد. بعد از تغيير XSL، يکبار ديگر فرمان Transformation را روی رکورهای مقالات و اخبار تکرارکنيد تا صفحات جديد را بدست آوريد.
لازم به ذکر است منبع مقاله یادم نیست