http://www.mediawiki.org/wiki/Special:Code/MediaWiki/88152
Revision: 88152
Author: mkroetzsch
Date: 2011-05-15 11:11:24 +0000 (Sun, 15 May 2011)
Log Message:
-----------
added data item implementation for containers
Modified Paths:
--------------
trunk/extensions/SemanticMediaWiki/includes/SMW_Setup.php
Added Paths:
-----------
trunk/extensions/SemanticMediaWiki/includes/dataitems/SMW_DI_Container.php
Modified: trunk/extensions/SemanticMediaWiki/includes/SMW_Setup.php
===================================================================
--- trunk/extensions/SemanticMediaWiki/includes/SMW_Setup.php 2011-05-15
11:01:27 UTC (rev 88151)
+++ trunk/extensions/SemanticMediaWiki/includes/SMW_Setup.php 2011-05-15
11:11:24 UTC (rev 88152)
@@ -137,20 +137,22 @@
// Data items
$diDir = $smwgIP . 'includes/dataitems/';
- $wgAutoloadClasses['SMWDataItem'] =
$diDir . 'SMW_DataItem.php';
- $wgAutoloadClasses['SMWDataItemException'] = $diDir .
'SMW_DataItem.php';
- $wgAutoloadClasses['SMWDIProperty'] =
$diDir . 'SMW_DI_Property.php';
- $wgAutoloadClasses['SMWDIBoolean'] =
$diDir . 'SMW_DI_Bool.php';
- $wgAutoloadClasses['SMWDINumber'] =
$diDir . 'SMW_DI_Number.php';
- $wgAutoloadClasses['SMWDIBlob'] =
$diDir . 'SMW_DI_Blob.php';
- $wgAutoloadClasses['SMWDIString'] =
$diDir . 'SMW_DI_String.php';
+ $wgAutoloadClasses['SMWDataItem'] = $diDir .
'SMW_DataItem.php';
+ $wgAutoloadClasses['SMWDataItemException'] = $diDir .
'SMW_DataItem.php';
+ $wgAutoloadClasses['SMWDIProperty'] = $diDir .
'SMW_DI_Property.php';
+ $wgAutoloadClasses['SMWDIBoolean'] = $diDir .
'SMW_DI_Bool.php';
+ $wgAutoloadClasses['SMWDINumber'] = $diDir .
'SMW_DI_Number.php';
+ $wgAutoloadClasses['SMWDIBlob'] = $diDir .
'SMW_DI_Blob.php';
+ $wgAutoloadClasses['SMWDIString'] = $diDir .
'SMW_DI_String.php';
$wgAutoloadClasses['SMWStringLengthException'] = $diDir .
'SMW_DI_String.php';
- $wgAutoloadClasses['SMWDIUri'] =
$diDir . 'SMW_DI_URI.php';
- $wgAutoloadClasses['SMWDIWikiPage'] =
$diDir . 'SMW_DI_WikiPage.php';
- $wgAutoloadClasses['SMWDITime'] =
$diDir . 'SMW_DI_Time.php';
- $wgAutoloadClasses['SMWDIConcept'] =
$diDir . 'SMW_DI_Concept.php';
- $wgAutoloadClasses['SMWDIError'] =
$diDir . 'SMW_DI_Error.php';
- $wgAutoloadClasses['SMWDIGeoCoord'] =
$diDir . 'SMW_DI_GeoCoord.php';
+ $wgAutoloadClasses['SMWDIUri'] = $diDir .
'SMW_DI_URI.php';
+ $wgAutoloadClasses['SMWDIWikiPage'] = $diDir .
'SMW_DI_WikiPage.php';
+ $wgAutoloadClasses['SMWDITime'] = $diDir .
'SMW_DI_Time.php';
+ $wgAutoloadClasses['SMWDIConcept'] = $diDir .
'SMW_DI_Concept.php';
+ $wgAutoloadClasses['SMWDIError'] = $diDir .
'SMW_DI_Error.php';
+ $wgAutoloadClasses['SMWDIGeoCoord'] = $diDir .
'SMW_DI_GeoCoord.php';
+ $wgAutoloadClasses['SMWContainerSemanticData'] = $diDir .
'SMW_DI_Container.php';
+ $wgAutoloadClasses['SMWDIContainer'] = $diDir .
'SMW_DI_Container.php';
// Datavalues
$dvDir = $smwgIP . 'includes/datavalues/';
Added:
trunk/extensions/SemanticMediaWiki/includes/dataitems/SMW_DI_Container.php
===================================================================
--- trunk/extensions/SemanticMediaWiki/includes/dataitems/SMW_DI_Container.php
(rev 0)
+++ trunk/extensions/SemanticMediaWiki/includes/dataitems/SMW_DI_Container.php
2011-05-15 11:11:24 UTC (rev 88152)
@@ -0,0 +1,142 @@
+<?php
+/**
+ * @file
+ * @ingroup SMWDataItems
+ */
+
+/**
+ * Subclass of SMWSemanticData that can be make read only to enforce the
+ * immutability of all SMW data items. This ensures that the container dataitem
+ * can safely give out an object reference without concern that this is
+ * exploited to indirectly change its content.
+ *
+ * Objects of this class are usually only made immutable when passed to a data
+ * item, so they can be built as usual. When cloning the object, the clone
+ * becomes mutable again. This is safe since all data is stored in arrays that
+ * contain only immutable objects and values of basic types. Arrays are copied
+ * (lazily) when cloning in PHP, so later changes in the cloce will not affect
+ * the original.
+ */
+class SMWContainerSemanticData extends SMWSemanticData {
+
+ /**
+ * If true, the object will not allow further changes.
+ * @var boolean
+ */
+ protected $m_immutable = false;
+
+ /**
+ * Constructor.
+ *
+ * @param boolean $noDuplicates stating if duplicate data should be
avoided
+ */
+ public function __construct( $noDuplicates = true ) {
+ $subject = new SMWDIWikiPage( 'SMWInternalObject', NS_SPECIAL,
'' ); // dummy subject
+ parent::__construct( $noDuplicates );
+ }
+
+ /**
+ * Clone handler. Make any clone mutable again.
+ */
+ public function __clone() {
+ $this->m_immutable = false;
+ }
+
+ /**
+ * Freeze the object: no more change operations allowed after calling
+ * this. Normally this is only called when passing the object to an
+ * SMWDIContainer. Other code should not need this.
+ */
+ public function makeImmutable() {
+ $this->m_immutable = true;
+ }
+
+ /**
+ * Store a value for a property identified by its SMWDataItem object,
+ * if the object was not set to immutable.
+ *
+ * @param $property SMWDIProperty
+ * @param $dataItem SMWDataItem
+ */
+ public function addPropertyObjectValue( SMWDIProperty $property,
SMWDataItem $dataItem ) {
+ $this->throwImmutableException();
+ parent::addPropertyObjectValue( $property, $dataItem );
+ }
+
+ /**
+ * Delete all data other than the subject, if the object was not set to
+ * immutable.
+ */
+ public function clear() {
+ $this->throwImmutableException();
+ parent::clear();
+ }
+
+ /**
+ * Throw an exception if the object is immutable.
+ */
+ protected function throwImmutableException() {
+ if ( $this->m_immutable ) {
+ throw SMWDataItemException( 'Changing the
SMWSemanticData object that belongs to a data item of type SMWDIContainer is
not allowed. Data items are immutable.' );
+ }
+ }
+}
+
+/**
+ * This class implements container data items that can store SMWSemanticData
+ * objects. In this sense, data items of this type are a kind of "internal
+ * object" that can contain the data that is otherwise associated with a wiki
+ * page.
+ *
+ * @since 1.6
+ *
+ * @author Markus Krötzsch
+ * @ingroup SMWDataItems
+ */
+class SMWDIContainer extends SMWDataItem {
+
+ /**
+ * Internal value.
+ * @var SMWSemanticData
+ */
+ protected $m_semanticData;
+
+ /**
+ * Constructor. The given SMWContainerSemanticData object will be owned
+ * by the constructed object afterwards, and in particular will not
+ * allow further changes.
+ *
+ * @param $semanticData SMWContainerSemanticData
+ */
+ public function __construct( SMWContainerSemanticData $semanticData,
$typeid = '_rec' ) {
+ parent::__construct( $typeid );
+ $this->m_semanticData = $semanticData;
+ $this->m_semanticData->makeImmutable();
+ }
+
+ public function getDIType() {
+ return SMWDataItem::TYPE_CONTAINER;
+ }
+
+ public function getSemanticData() {
+ return $this->m_semanticData;
+ }
+
+ public function getSortKey() {
+ return '';
+ }
+
+ public function getSerialization() {
+ return $this->m_string;
+ }
+
+ /**
+ * Create a data item from the provided serialization string and type
+ * ID.
+ * @return SMWDIContainer
+ */
+ public static function doUnserialize( $serialization, $typeid = '_rec'
) {
+ return new SMWDIBlob( $serialization, $typeid );
+ }
+
+}
Property changes on:
trunk/extensions/SemanticMediaWiki/includes/dataitems/SMW_DI_Container.php
___________________________________________________________________
Added: svn:eol-style
+ native
_______________________________________________
MediaWiki-CVS mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/mediawiki-cvs
