collection_redesign.xmi

Amarok是一款在LINUX或其他类UNIX操作系统中运行的音频播放器软件。 经过两年开发后

<?xml version="1.0" encoding="UTF-8"?>
<XMI xmlns:UML="http://schema.omg.org/spec/UML/1.3" verified="false" timestamp="2007-01-21T11:38:24" xmi.version="1.2" >
 <XMI.header>
  <XMI.documentation>
   <XMI.exporter>umbrello uml modeller http://uml.sf.net</XMI.exporter>
   <XMI.exporterVersion>1.5.5</XMI.exporterVersion>
   <XMI.exporterEncoding>UnicodeUTF8</XMI.exporterEncoding>
  </XMI.documentation>
  <XMI.metamodel xmi.name="UML" href="UML.xml" xmi.version="1.3" />
 </XMI.header>
 <XMI.content>
  <UML:Model isSpecification="false" isLeaf="false" isRoot="false" xmi.id="m1" isAbstract="false" name="UML Model" >
   <UML:Namespace.ownedElement>
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="2" isRoot="false" isAbstract="false" name="folder" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="2" isRoot="false" isAbstract="false" name="folder" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4394" isRoot="false" isAbstract="false" name="datatype" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4405" isRoot="false" isAbstract="false" name="constructor" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4406" isRoot="false" isAbstract="false" name="friend" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4407" isRoot="false" isAbstract="false" name="virtual" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4410" isRoot="false" isAbstract="false" name="interface" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="2" isRoot="false" isAbstract="false" name="folder" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4394" isRoot="false" isAbstract="false" name="datatype" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4405" isRoot="false" isAbstract="false" name="constructor" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4406" isRoot="false" isAbstract="false" name="friend" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4407" isRoot="false" isAbstract="false" name="virtual" />
    <UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4410" isRoot="false" isAbstract="false" name="interface" />
    <UML:Model stereotype="2" isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="1" isRoot="false" isAbstract="false" name="Logical View" >
     <UML:Namespace.ownedElement>
      <UML:Package stereotype="2" isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="8" isRoot="false" isAbstract="false" name="Datatypes" >
       <UML:Namespace.ownedElement>
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4393" isRoot="false" isAbstract="false" name="int" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4395" isRoot="false" isAbstract="false" name="char" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4396" isRoot="false" isAbstract="false" name="bool" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4397" isRoot="false" isAbstract="false" name="float" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4398" isRoot="false" isAbstract="false" name="double" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4399" isRoot="false" isAbstract="false" name="short" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4400" isRoot="false" isAbstract="false" name="long" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4401" isRoot="false" isAbstract="false" name="unsigned int" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4402" isRoot="false" isAbstract="false" name="unsigned short" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4403" isRoot="false" isAbstract="false" name="unsigned long" />
        <UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4404" isRoot="false" isAbstract="false" name="string" />
       </UML:Namespace.ownedElement>
      </UML:Package>
      <UML:Class comment="This singleton is the " isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="4408" isRoot="false" isAbstract="false" name="CollectionManager" >
       <UML:Classifier.feature>
        <UML:Operation comment="factory method for this singleton." isSpecification="false" isLeaf="false" visibility="public" xmi.id="9274" isRoot="false" isAbstract="false" isQuery="false" name="instance" ownerScope="classifier" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14465" type="4408" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation isSpecification="false" isLeaf="false" visibility="private" xmi.id="12814" isRoot="false" isAbstract="false" isQuery="false" name="CollectionManager" />
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4458" isRoot="false" isAbstract="false" isQuery="false" name="queryBuilder" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14466" type="4409" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="6143" isRoot="false" isAbstract="false" isQuery="false" name="startFullScan" />
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="6395" isRoot="false" isAbstract="false" isQuery="false" name="collectionLocations" />
       </UML:Classifier.feature>
      </UML:Class>
      <UML:Interface stereotype="4410" comment="Abstract base class for QueryBuilder implementations. All implementations must return this when the return type is QueryBuilder to allow method chaining." isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="4409" isRoot="false" isAbstract="true" name="QueryBuilder" >
       <UML:Classifier.feature>
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4714" isRoot="false" isAbstract="true" isQuery="false" name="signalNewResultReady" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter comment="Identifies the collection which returned the new results. QString is just a placeholder" isSpecification="false" visibility="private" xmi.id="4739" value="" type="4736" name="collectionId" />
          <UML:Parameter comment="the songs which were found by the collection for the given query. The calling function takes ownership of the objects." isSpecification="false" visibility="private" xmi.id="4745" value="" type="4742" name="songs" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="13516" isRoot="false" isAbstract="true" isQuery="false" name="signalNewResultReady" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter isSpecification="false" visibility="private" xmi.id="13517" value="" type="4736" name="collectionId" />
          <UML:Parameter isSpecification="false" visibility="private" xmi.id="13601" value="" type="13559" name="albums" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="13348" isRoot="false" isAbstract="true" isQuery="false" name="signalNewResultReady" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter isSpecification="false" visibility="private" xmi.id="13349" value="" type="4736" name="collectionId" />
          <UML:Parameter isSpecification="false" visibility="private" xmi.id="13433" value="" type="13391" name="artists" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4750" isRoot="false" isAbstract="true" isQuery="false" name="signalNewResultReady" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter comment="identifies the collection which returned this result. The type is just a placeholder, there are probably better choices than a QString" isSpecification="false" visibility="private" xmi.id="4751" value="" type="4736" name="collectionId" />
          <UML:Parameter comment="The result of the given query." isSpecification="false" visibility="private" xmi.id="4757" value="" type="4754" name="result" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation comment="start the defined query. this method will not block but return immediately." isSpecification="false" isLeaf="false" visibility="public" xmi.id="4724" isRoot="false" isAbstract="true" isQuery="false" name="run" />
        <UML:Operation comment="This method starts a song query. A song query will return Song objects and does not allow you to add additional return values by calling addReturnValue()" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4762" isRoot="false" isAbstract="true" isQuery="false" name="startSongQuery()" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14467" type="4409" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="13726" isRoot="false" isAbstract="true" isQuery="false" name="startAlbumQuery" />
        <UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="13684" isRoot="false" isAbstract="true" isQuery="false" name="startArtistQuery" />
        <UML:Operation comment="starts a custom query. A custom query allows the client code define the needed return values by calling addReturnValue(). Do not use this method if you want songs, use startSongQuery() instead." isSpecification="false" isLeaf="false" visibility="public" xmi.id="4765" isRoot="false" isAbstract="true" isQuery="false" name="startCustomQuery" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14468" type="4409" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation comment="resets the query represented by the QueryBuilder. After calling this method the state of the QueryBuilder instance is equal to a new one created by calling CollectionManager's queryBuilder() method." isSpecification="false" isLeaf="false" visibility="public" xmi.id="4768" isRoot="false" isAbstract="true" isQuery="false" name="reset()" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14469" type="4409" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation comment="adds a filter to the query.
TODO: add parameters" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4771" isRoot="false" isAbstract="true" isQuery="false" name="addFilter" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14470" type="4409" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation comment="define the sort order of the returned result.
TODO: add parameters" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4774" isRoot="false" isAbstract="true" isQuery="false" name="orderBy" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14471" type="4409" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation comment="aborts a running query. Calling this method has no effect if query wasnt run yet or the QueryBuilder already returned the results for the query. The QueryBuilder instance will try to exit as soon as possible after calling this method." isSpecification="false" isLeaf="false" visibility="public" xmi.id="4792" isRoot="false" isAbstract="true" isQuery="false" name="abortQuery" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14472" type="4409" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation comment="adds a return value to the query. NOTE: calls to this method are ignored if you started a song query by calling startSongQuery()" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4809" isRoot="false" isAbstract="true" isQuery="false" name="addReturnValue" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14473" type="4409" />
         </UML:BehavioralFeature.parameter>
        </UML:Operation>
        <UML:Operation comment="This signal is emitted when the query completed and no additional signalNewResultReady() signals will be emitted." isSpecification="false" isLeaf="false" visibility="public" xmi.id="8743" isRoot="false" isAbstract="true" isQuery="false" name="signalQueryDone" />
        <UML:Operation comment="include the collection identified by the collection id in this query. By default, all collections are queried. After this calling this method once, all collections which are not explicitly included are not queried." isSpecification="false" isLeaf="false" visibility="public" xmi.id="9377" isRoot="false" isAbstract="true" isQuery="false" name="includeCollection" >
         <UML:BehavioralFeature.parameter>
          <UML:Parameter kind="return" xmi.id="14474" type="4409" />
          <UML:Parameter isSpecification="false" visibility="private" xmi.id="9378" value="" type="4736" name="collectionId" />