// ================================================================================================
//
// MediaWikiのウェブサイト(システム)をあらわすモデルクラスソース
//
//
// Copyright (C) 2012 Honeplus. All rights reserved.
//
// Honeplus
// ================================================================================================
namespace Honememo.Wptscs.Websites
{
using System;
using System.Collections.Generic;
using System.IO;
using System.Xml;
using System.Xml.Serialization;
using Honememo.Utilities;
using Honememo.Wptscs.Models;
using Honememo.Wptscs.Properties;
using Honememo.Wptscs.Utilities;
///
/// MediaWikiのウェブサイト(システム)をあらわすモデルクラスです。
///
public class MediaWiki : Website, IXmlSerializable
{
#region private変数
///
/// 名前空間情報取得用にアクセスするAPI。
///
private string namespacePath;
///
/// 記事のXMLデータが存在するパス。
///
private string exportPath;
///
/// リダイレクトの文字列。
///
private string redirect;
///
/// テンプレートの名前空間を示す番号。
///
private int? templateNamespace;
///
/// カテゴリの名前空間を示す番号。
///
private int? categoryNamespace;
///
/// 画像の名前空間を示す番号。
///
private int? fileNamespace;
///
/// Wikipedia書式のシステム定義変数。
///
/// 初期値は http://www.mediawiki.org/wiki/Help:Magic_words を参照
private IList magicWords;
///
/// MediaWikiの名前空間の情報。
///
private IDictionary> namespaces = new Dictionary>();
#endregion
#region コンストラクタ
///
/// コンストラクタ(MediaWiki全般)。
///
/// ウェブサイトの言語。
/// ウェブサイトの場所。
public MediaWiki(Language language, string location) : this()
{
// メンバ変数の初期設定
this.Language = language;
this.Location = location;
}
///
/// コンストラクタ(Wikipedia用)。
///
/// ウェブサイトの言語。
public MediaWiki(Language language) : this()
{
// メンバ変数の初期設定
// ※ オーバーロードメソッドを呼んでいないのは、languageがnullのときに先にエラーになるから
this.Language = language;
this.Location = String.Format(Settings.Default.WikipediaLocation, language.Code);
}
///
/// コンストラクタ(シリアライズ or 拡張用)。
///
protected MediaWiki()
{
this.WebProxy = new AppDefaultWebProxy();
this.DocumentationTemplates = new List();
}
#endregion
#region 設定ファイルに初期値を持つプロパティ
///
/// MediaWiki名前空間情報取得用にアクセスするAPI。
///
/// 値が指定されていない場合、デフォルト値を返す。
public string NamespacePath
{
get
{
if (String.IsNullOrEmpty(this.namespacePath))
{
return Settings.Default.MediaWikiNamespacePath;
}
return this.namespacePath;
}
set
{
this.namespacePath = value;
}
}
///
/// 記事のXMLデータが存在するパス。
///
/// 値が指定されていない場合、デフォルト値を返す。
public string ExportPath
{
get
{
if (String.IsNullOrEmpty(this.exportPath))
{
return Settings.Default.MediaWikiExportPath;
}
return this.exportPath;
}
set
{
this.exportPath = value;
}
}
///
/// リダイレクトの文字列。
///
/// 値が指定されていない場合、デフォルト値を返す。
public string Redirect
{
get
{
if (String.IsNullOrEmpty(this.redirect))
{
return Settings.Default.MediaWikiRedirect;
}
return this.redirect;
}
set
{
this.redirect = value;
}
}
///
/// テンプレートの名前空間を示す番号。
///
/// 値が指定されていない場合、デフォルト値を返す。
public int TemplateNamespace
{
get
{
return this.templateNamespace ?? Settings.Default.MediaWikiTemplateNamespace;
}
set
{
this.templateNamespace = value;
}
}
///
/// カテゴリの名前空間を示す番号。
///
/// 値が指定されていない場合、デフォルト値を返す。
public int CategoryNamespace
{
get
{
return this.categoryNamespace ?? Settings.Default.MediaWikiCategoryNamespace;
}
set
{
this.categoryNamespace = value;
}
}
///
/// 画像の名前空間を示す番号。
///
/// 値が指定されていない場合、デフォルト値を返す。
public int FileNamespace
{
get
{
return this.fileNamespace ?? Settings.Default.MediaWikiFileNamespace;
}
set
{
this.fileNamespace = value;
}
}
///
/// Wikipedia書式のシステム定義変数。
///
/// 値が指定されていない場合、デフォルト値を返す。
public IList MagicWords
{
get
{
if (this.magicWords == null)
{
string[] w = new string[Settings.Default.MediaWikiMagicWords.Count];
Settings.Default.MediaWikiMagicWords.CopyTo(w, 0);
return w;
}
return this.magicWords;
}
set
{
this.magicWords = value;
}
}
#endregion
#region それ以外のプロパティ
///
/// MediaWikiの名前空間の情報。
///
/// 値が指定されていない場合、サーバーから情報を取得。
public IDictionary> Namespaces
{
get
{
lock (this.namespaces)
{
// 値が設定されていない場合、サーバーから取得して初期化する
// ※ コンストラクタ等で初期化していないのは、通信の準備が整うまで行えないため
// ※ MagicWordsがnullでこちらが空で若干条件が違うのは、あちらは設定ファイルに
// 保存する設定だが、こちらは設定ファイルに保存しない基本的に読み込み用の設定だから。
if (this.namespaces.Count > 0)
{
return this.namespaces;
}
// APIのXMLデータをMediaWikiサーバーから取得
XmlDocument xml = new XmlDocument();
using (Stream reader = this.WebProxy.GetStream(new Uri(new Uri(this.Location), this.NamespacePath)))
{
xml.Load(reader);
}
// ルートエレメントまで取得し、フォーマットをチェック
XmlElement rootElement = xml["api"];
if (rootElement == null)
{
// XMLは取得できたが空 or フォーマットが想定外
throw new InvalidDataException("parse failed");
}
// クエリーを取得
XmlElement queryElement = rootElement["query"];
if (queryElement == null)
{
// フォーマットが想定外
throw new InvalidDataException("parse failed");
}
// ネームスペースブロックを取得、ネームスペースブロックまでは必須
XmlElement namespacesElement = queryElement["namespaces"];
if (namespacesElement == null)
{
// フォーマットが想定外
throw new InvalidDataException("parse failed");
}
// ネームスペースを取得
foreach (XmlNode node in namespacesElement.ChildNodes)
{
XmlElement namespaceElement = node as XmlElement;
if (namespaceElement != null)
{
try
{
int id = Decimal.ToInt16(Decimal.Parse(namespaceElement.GetAttribute("id")));
IList values = new List();
values.Add(namespaceElement.InnerText);
this.namespaces[id] = values;
// あればシステム名?も設定
string canonical = namespaceElement.GetAttribute("canonical");
if (!String.IsNullOrEmpty(canonical))
{
values.Add(canonical);
}
}
catch (Exception e)
{
// キャッチしているのは、万が一想定外の書式が返された場合に、完璧に動かなくなるのを防ぐため
System.Diagnostics.Debug.WriteLine("MediaWiki.Namespaces > 例外発生 : " + e);
}
}
}
// ネームスペースエイリアスブロックを取得、無い場合も想定
XmlElement aliasesElement = queryElement["namespacealiases"];
if (aliasesElement != null)
{
// ネームスペースエイリアスを取得
foreach (XmlNode node in aliasesElement.ChildNodes)
{
XmlElement namespaceElement = node as XmlElement;
if (namespaceElement != null)
{
try
{
int id = Decimal.ToInt16(Decimal.Parse(namespaceElement.GetAttribute("id")));
IList values = new List();
if (this.namespaces.ContainsKey(id))
{
values = this.namespaces[id];
}
values.Add(namespaceElement.InnerText);
}
catch (Exception e)
{
// キャッチしているのは、万が一想定外の書式が返された場合に、完璧に動かなくなるのを防ぐため
System.Diagnostics.Debug.WriteLine("MediaWiki.Namespaces > 例外発生 : " + e);
}
}
}
}
}
return this.namespaces;
}
set
{
// ※必須な情報が設定されていない場合、ArgumentNullExceptionを返す
if (value == null)
{
throw new ArgumentNullException("namespaces");
}
this.namespaces = value;
}
}
///
/// Template:Documentation(言語間リンク等を別ページに記述するためのテンプレート)に相当するページ名。
///
/// 空の場合、その言語版にはこれに相当する機能は無いものとして扱う。
public IList DocumentationTemplates
{
get;
protected set;
}
///
/// Template:Documentationで指定が無い場合に参照するページ名。
///
///
/// ほとんどの言語では[[/Doc]]の模様。
/// 空の場合、明示的な指定が無い場合は参照不能として扱う。
///
public string DocumentationTemplateDefaultPage
{
get;
set;
}
///
/// Template:仮リンク(他言語へのリンク)で書式化するためのフォーマット。
///
/// 空の場合、その言語版にはこれに相当する機能は無いor使用しないものとして扱う。
public string LinkInterwikiFormat
{
get;
set;
}
///
/// Template:Langで書式化するためのフォーマット。
///
/// 空の場合、その言語版にはこれに相当する機能は無いor使用しないものとして扱う。
public string LangFormat
{
get;
set;
}
///
/// このクラスで使用するWebアクセス用Proxyインスタンス。
///
/// setterはユニットテスト用に公開。
public IWebProxy WebProxy
{
protected get;
set;
}
#endregion
#region 公開メソッド
///
/// ページを取得。
///
/// ページタイトル。
/// 取得したページ。
/// ページが存在しない場合。
/// 末尾がピリオドのページの場合(既知の不具合への対応)。
/// ページの取得に失敗した場合(通信エラーなど)は、その状況に応じた例外を投げる。
public override Page GetPage(string title)
{
// fileスキームの場合、記事名からファイルに使えない文字をエスケープ
// ※ 仕組み的な処理はWebsite側に置きたいが、向こうではタイトルだけを抽出できないので
string escapeTitle = title;
if (new Uri(this.Location).IsFile)
{
escapeTitle = FormUtils.ReplaceInvalidFileNameChars(title);
}
// URIを生成
Uri uri = new Uri(new Uri(this.Location), StringUtils.FormatDollarVariable(this.ExportPath, escapeTitle));
if (uri.OriginalString.EndsWith("."))
{
// 末尾がピリオドのページが取得できない既知の不具合への暫定対応
// 対処方法が不明なため、せめて例外を投げて検知する
throw new NotSupportedException(title + " is not suppoted");
}
// ページのXMLデータをMediaWikiサーバーから取得
XmlDocument xml = new XmlDocument();
try
{
using (Stream reader = this.WebProxy.GetStream(uri))
{
xml.Load(reader);
}
}
catch (System.Net.WebException e)
{
// 404エラーによるページ取得失敗は詰め替えて返す
if (this.IsNotFound(e))
{
throw new FileNotFoundException("page not found", e);
}
throw e;
}
// ルートエレメントまで取得し、フォーマットをチェック
XmlElement rootElement = xml["mediawiki"];
if (rootElement == null)
{
// XMLは取得できたが空 or フォーマットが想定外
throw new InvalidDataException("parse failed");
}
// ページの解析
XmlElement pageElement = rootElement["page"];
if (pageElement == null)
{
// ページ無し
throw new FileNotFoundException("page not found");
}
// ページ名、ページ本文、最終更新日時
// ※ 一応、各項目が無くても動作するようにする
string pageTitle = XmlUtils.InnerText(pageElement["title"], title);
string text = null;
DateTime? time = null;
XmlElement revisionElement = pageElement["revision"];
if (revisionElement != null)
{
text = XmlUtils.InnerText(revisionElement["text"], null);
XmlElement timeElement = revisionElement["timestamp"];
if (timeElement != null)
{
time = new DateTime?(DateTime.Parse(timeElement.InnerText));
}
}
// ページ情報を作成して返す
return new MediaWikiPage(this, pageTitle, text, time);
}
///
/// 指定された文字列がWikipediaのシステム変数に相当かを判定。
///
/// チェックする文字列。
/// true システム変数に相当。
public bool IsMagicWord(string text)
{
string s = text != null ? text : String.Empty;
// {{CURRENTYEAR}}や{{ns:1}}みたいなパターンがある
foreach (string variable in this.MagicWords)
{
if (s == variable || s.StartsWith(variable + ":"))
{
return true;
}
}
return false;
}
///
/// を渡された記事名, 言語, 他言語版記事名, 表示名で書式化した文字列を返す。
///
/// 記事名。
/// 言語。
/// 他言語版記事名。
/// 表示名。
/// 書式化した文字列。が未設定の場合null。
public string FormatLinkInterwiki(string title, string lang, string langTitle, string label)
{
if (String.IsNullOrEmpty(this.LinkInterwikiFormat))
{
return null;
}
return StringUtils.FormatDollarVariable(this.LinkInterwikiFormat, title, lang, langTitle, label);
}
///
/// を渡された言語, 文字列で書式化した文字列を返す。
///
/// 言語。
/// 文字列。
/// 書式化した文字列。が未設定の場合null。
///
/// このlangとのコードは、厳密には一致しないケースがあるが
/// (例、simple→en)、2012年2月現在の実装ではそこまで正確さは要求していない。
///
public string FormatLang(string lang, string text)
{
if (String.IsNullOrEmpty(this.LangFormat))
{
return null;
}
return StringUtils.FormatDollarVariable(this.LangFormat, lang, text);
}
#endregion
#region XMLシリアライズ用メソッド
///
/// シリアライズするXMLのスキーマ定義を返す。
///
/// XML表現を記述するXmlSchema。
public System.Xml.Schema.XmlSchema GetSchema()
{
return null;
}
///
/// XMLからオブジェクトをデシリアライズする。
///
/// デシリアライズ元のXmlReader
public void ReadXml(XmlReader reader)
{
XmlDocument xml = new XmlDocument();
xml.Load(reader);
// Webサイト
// ※ 以下、基本的に無かったらNGの部分はいちいちチェックしない。例外飛ばす
XmlElement siteElement = xml.DocumentElement;
this.Location = siteElement.SelectSingleNode("Location").InnerText;
using (XmlReader r = XmlReader.Create(
new StringReader(siteElement.SelectSingleNode("Language").OuterXml), reader.Settings))
{
this.Language = new XmlSerializer(typeof(Language)).Deserialize(r) as Language;
}
this.NamespacePath = XmlUtils.InnerText(siteElement.SelectSingleNode("NamespacePath"));
this.ExportPath = XmlUtils.InnerText(siteElement.SelectSingleNode("ExportPath"));
this.Redirect = XmlUtils.InnerText(siteElement.SelectSingleNode("Redirect"));
string text = XmlUtils.InnerText(siteElement.SelectSingleNode("TemplateNamespace"));
if (!String.IsNullOrEmpty(text))
{
this.TemplateNamespace = int.Parse(text);
}
text = XmlUtils.InnerText(siteElement.SelectSingleNode("CategoryNamespace"));
if (!String.IsNullOrEmpty(text))
{
this.CategoryNamespace = int.Parse(text);
}
text = XmlUtils.InnerText(siteElement.SelectSingleNode("FileNamespace"));
if (!String.IsNullOrEmpty(text))
{
this.FileNamespace = int.Parse(text);
}
// システム定義変数
IList variables = new List();
foreach (XmlNode variableNode in siteElement.SelectNodes("MagicWords/Variable"))
{
variables.Add(variableNode.InnerText);
}
if (variables.Count > 0)
{
// 初期値の都合上、値がある場合のみ
this.MagicWords = variables;
}
// Template:Documentationの設定
this.DocumentationTemplates = new List();
foreach (XmlNode docNode in siteElement.SelectNodes("DocumentationTemplates/DocumentationTemplate"))
{
this.DocumentationTemplates.Add(docNode.InnerText);
XmlElement docElement = docNode as XmlElement;
if (docElement != null)
{
// ※ XML上DefaultPageはテンプレートごとに異なる値を持てるが、
// そうした例を見かけたことがないため、代表で一つの値のみ使用
// (複数値が持てるのも、リダイレクトが存在するためその対策として)
this.DocumentationTemplateDefaultPage = docElement.GetAttribute("DefaultPage");
}
}
this.LinkInterwikiFormat = XmlUtils.InnerText(siteElement.SelectSingleNode("LinkInterwikiFormat"));
this.LangFormat = XmlUtils.InnerText(siteElement.SelectSingleNode("LangFormat"));
}
///
/// オブジェクトをXMLにシリアライズする。
///
/// シリアライズ先のXmlWriter
public void WriteXml(XmlWriter writer)
{
writer.WriteElementString("Location", this.Location);
new XmlSerializer(this.Language.GetType()).Serialize(writer, this.Language);
// MediaWiki固有の情報
// ※ 設定ファイルに初期値を持つものは、プロパティではなく値から出力
writer.WriteElementString("NamespacePath", this.namespacePath);
writer.WriteElementString("ExportPath", this.exportPath);
writer.WriteElementString("Redirect", this.redirect);
writer.WriteElementString(
"TemplateNamespace",
this.templateNamespace.HasValue ? this.templateNamespace.ToString() : String.Empty);
writer.WriteElementString(
"CategoryNamespace",
this.templateNamespace.HasValue ? this.categoryNamespace.ToString() : String.Empty);
writer.WriteElementString(
"FileNamespace",
this.templateNamespace.HasValue ? this.fileNamespace.ToString() : String.Empty);
// システム定義変数
writer.WriteStartElement("MagicWords");
if (this.magicWords != null)
{
foreach (string variable in this.magicWords)
{
writer.WriteElementString("Variable", variable);
}
}
// Template:Documentationの設定
writer.WriteEndElement();
writer.WriteStartElement("DocumentationTemplates");
foreach (string doc in this.DocumentationTemplates)
{
writer.WriteStartElement("DocumentationTemplate");
writer.WriteAttributeString("DefaultPage", this.DocumentationTemplateDefaultPage);
writer.WriteValue(doc);
writer.WriteEndElement();
}
writer.WriteEndElement();
writer.WriteElementString("LinkInterwikiFormat", this.LinkInterwikiFormat);
writer.WriteElementString("LangFormat", this.LangFormat);
}
#endregion
}
}