ICO wiki - User contributions [en]

Terav C - Võrgurakendused 2 - projektileht

2013-06-10T21:33:19Z

Atsernik: /* Windows phone 8 rakendus */

== Üldist ==
=== Liikmed ===
* Aleksandr Laidoner
* Oliver Dalberg
* Tarmo Sillajõe
* Andre Tšernikov

=== Teema valik - Pildiportaal ===
Valisime teemaks pildiportaali.

== Ülesanne 1 - XML ==
Tähtaeg 15.04.2013
=== XML - fail ===
Antud xml'i annab välja Pildiportaali veebiteenus selleks, et kliendid saaks kuvada galerii infot.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii.xml TeravC-galerii.xml]

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<galeriid>
<galerii id="1" kategooria="Loomad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="KB">200</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="3" vaade="suur">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">3</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="4" vaade="ikoon">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>png</formaat>
<suurus yhik="KB">230</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
<galerii id="2" kategooria="Linnad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>raw</formaat>
<suurus yhik="KB">220</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
</galeriid>

</source>

=== XSL - stiilifailid ===

==== Stiilifail 1 - inimsõbralik vaade xml faili sisust ====
Antud stiilifail vormindab inimsõbralikul tabeli kujul ülaloleva XML'i
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html1.xslt TeravC-galerii-xsl-html1.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>XML to HTML 1</title>
<style>
.theader { font-style:italic; text-decoration:underline; }
</style>

</head>
<body>
<H1>getPildid sõnumi sisu.</H1>
<xsl:for-each select="/galeriid/galerii">
<h3>
<xsl:text>Galerii nr. </xsl:text>
<xsl:value-of select="@id"/>
<xsl:text> (</xsl:text>
<xsl:value-of select="@kategooria"/>
<xsl:text>)</xsl:text>
</h3>
<table>
<tr class="theader">
<td>pilt.number</td>
<td>pilt.vaade</td>
<td>nimi</td>
<td>kirjeldus</td>
<td>formaat</td>
<td>suurus</td>
</tr>
<xsl:for-each select ="pildid/pilt">
<tr>
<td>
<xsl:value-of select="@number"/>
</td>
<td>
<xsl:value-of select="@vaade"/>
</td>
<td>
<xsl:value-of select="nimi"/>
</td>
<td>
<xsl:value-of select="kirjeldus"/>
</td>
<td>
<xsl:value-of select="formaat"/>
</td>
<td>
<xsl:value-of select="suurus"/>
<xsl:value-of select="suurus/@yhik"/>
</td>
</tr>
</xsl:for-each>
</table>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>

</source>

==== Stiilifail 2 - galerii vaade (ikoonid) ====
Antud stiilifail vormindab XML'i galeriilaadseks HTML'iks
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html2.xslt TeravC-galerii-xsl-html2.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>XML to HTML - Gallery</title>
<style>
div.img
{
margin: 2px;
border: 1px solid #0000ff;
height: auto;
width: auto;
float: left;
text-align: center;
}
div.img img
{
display: inline;
margin: 3px;
border: 1px solid #ffffff;
}
div.img a:hover img {border: 1px solid #0000ff;}
div.desc
{
text-align: center;
font-weight: normal;
width: 120px;
margin: 2px;
}
</style>

</head>
<body>
<xsl:for-each select="/galeriid/galerii">
<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<div class="img">
<a target="_blank" href="#">
<img
src="http://fc09.deviantart.net/fs6/i/2005/039/d/c/Not_Available_Icon_by_blacxthornE.jpg"
width="110"
height="90"/>

</a>
<div class="desc">
<xsl:value-of select="kirjeldus"/>
</div>
</div>
</xsl:if>
</xsl:for-each>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>
</source>

==== Stiilifail 3 - thumbnails xml ====
Antud stiilifail vormindab xml'i ringi selliselt, et kuvab masinsõbralikul kujul xml'i.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-xml.xslt TeravC-galerii-xsl-xml.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<thumbnails>

<xsl:for-each select="/galeriid/galerii">

<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<thumb>
<xsl:attribute name="number">
<xsl:value-of select="@number"/>
</xsl:attribute>
<nimi>
<xsl:value-of select="nimi"/>
</nimi>
<kirjeldus>
<xsl:value-of select="kirjeldus"/>
</kirjeldus>
<url>
<xsl:text>http://pildiportaal.mingidomeen.ee/getThumb.aspx?id=</xsl:text>
<xsl:value-of select="@number"/>
</url>
<lisatud>
<xsl:value-of select="lisatud/aasta"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/kuu"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/paev"/>
</lisatud>
</thumb>

</xsl:if>
</xsl:for-each>
</xsl:for-each>

</thumbnails>
</xsl:template>
</xsl:stylesheet>

</source>

=== Skeemifail ===
Antud skeemifail mõeldud ülalova ning sellelaadse xml faili valideerimiseks
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="yhikuTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="KB"/>
<xs:enumeration value="MB"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="vaateTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="ikoon"/>
<xs:enumeration value="suur"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="kategooriaTyyp">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][a-z]+"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="galeriid">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="galerii">
<xs:complexType>
<xs:sequence>
<xs:element name="pildid">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="200" name="pilt">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string" />
<xs:element name="kirjeldus" type="xs:string" />
<xs:element name="formaat" type="xs:string" />
<xs:element name="suurus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:unsignedInt">
<xs:attribute name="yhik" type="yhikuTyyp" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="lisatud">
<xs:complexType>
<xs:sequence>
<xs:element name="paev" type="xs:unsignedByte"/>
<xs:element name="kuu" type="xs:unsignedByte"/>
<xs:element name="aasta" type="xs:unsignedShort"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="number" type="xs:unsignedInt" use="required" />
<xs:attribute name="vaade" type="vaateTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="kategooria" type="kategooriaTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</source>

== Retsensioonid ==
XML

Kodutööna on loodud xml fail pildiportaali veebiteenuse välja andmiseks. Pildiportaal on mõeldud klientidele galerii info kuvamiseks. Xml failis on 6 loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat kui lihtsalt id. Lisaks on loodud ka xsd vormingus skeemifail xml faili valideerimiseks. Xml failile on loodud ka 3 xslt stiilifaili: esimene neist annab välja html vormingus tabeli – tabelis on toodud iga pildi number, vaade, nimi, kirjeldus, vormingu ning suuruse andmed. Lisaks on pildid tabelitesse jaotatud kategooriate järgi ning galeriid on ka nummerdatud; teise stiilifaili eesmärk on algse xml faili andmetest vormindada galeriilaadne html, mida see stiilifail ka teeb; kolmas stiilifail vormindab algse xml-i ringi selliselt, et kuvab masinsõbralikul kujul xml'i pildi nime, kirjelduse, url aadressi ning lisamise kuupäeva andmetega. Kodutöö vastab seega täielikult esitatud tingimustele.

Kood otseselt kommenteeritud ei ole, aga see-eest on iga faili üldotstarve välja toodud meeskonna wiki lehel iga konkreetse faili juures. Samuti on kood loetav ja arusaadav.

Dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga see ei olnud ka nõutud kodutöö ülesande püstituses. Seega ei saa seda lugeda tehtud töö puuduseks hindamise mõttes. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba praegu dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena tooks ehk välja, et pildi juures ei ole pildi lisaja või tegija andmeid. Tänases päevas on igasugused autoriõigused väga kuum teema.

Meeskond Leemur

== XML retsensioon ==

Esitatud xml’i peaks genereerima Pildiportaali veebiteenus. XML vastab igati kodutöö nõuetes kirjeldatud tingimustele: xml sisaldab kuus loogilist dimensiooni ja kasutatud on piisavalt atribuute. Sisu on igati loogiline, ehk oleks võinud ainult lisada veel ühe dimensiooni ja viia eraldi gruppidesse nö „ikoonid“ ja „suured“ pildid aga eks see on ka suuresti maitse asi.

Esimene xslt fail andis tulemuseks html kujul ilusa tabeli galeriides olevatest piltidest, näha on, et autorid olid sellega ka vaeva näinud ja kenasti tulemuse ära formaatinud. Teine xslt annab juba html kujul galeriivaate ikoonidest, mis on ka valmisolekuga lisada sinna link suuremale pildile (hetkel veel puudub aga pole ka selle ülesande skoobi mõttes oluline). Kolmas xslt moodustab algsest xml-st uue spetsiifilisema xml faili. Teeb seda päris kenasti, aga url-i leidmisel tekib väike viga. Nimelt ei ole seal arvestatud mitme galerii olemasoluga, kus id-sid alustatakse ühest alates. See on tekitanud selle, et url kahe erineva galerii piltidele sama id-ga on sisult identsed. Antud ülesande mõttes seda veaks ei loeks, kuna tehniliselt kõik toimib aga kui hilisemas faasis ka seda kasutada saab, siis peaks natuke xslt skripti täiendama.

Kokkuvõtteks võib öelda, et meeskond TeravC XML kodutöö vastab kõigile esitatud nõuetele ja on hästi teostatud. Kõik esitatud failid ka valideerusid.

Meeskond Hops

== Ülesanne 2 - Veebiteenus ==
Tähtaeg 20.05.2013

=== Web API lahendus 2013-05-20 ===
*Esmalt vabandame kõigi retsenseerijate ees - ei jõudnud väga testida.Kood on kättesaadav: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-20.zip PictureSolution_2013-05-20.zip]
*Õppejõule ligipääasetav TFS projekt: [https://oliverd.visualstudio.com https://oliverd.visualstudio.com]
* Lisandus 26.05.2013 silutud ja ilusamaks tehtud: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-26.zip PictureSolution_2013-05-26.zip]
==== Testiabi ====
===== Pildi loomine =====
* Uue pildi tekitamiseks tuleb laadida pilt ülesse. Selleks kasuta Upload Controllerit (~/Upload). Kasutaja ja parooli saab spikerdada PictureDAL -> Migrations -> Configurations.cs.
* ImageUpload api-controller annab tagasi Image tüüpi objekti, mida siis saab sisse süüa, vajaduse täiendada, ning PUT käsuga uuendada serveris (Kasutades nüüd juba Image api-controllerit)

===== Uue objekti loomine =====
Näiteks uue kommentaari lisamiseks kasuta alljärgnevat päringud fiddleris:
POST http://localhost:55878/api/imagecomment HTTP/1.1
Host: localhost:55878
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Authorization: Basic YWRtaW46c2VjcmV0

{
"ImageID": 1,
"Comment": "Comment 2, hinne 6",
"Rating": 6,
}

==== Audentimisest ====
Kasutame basic-audentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Lahenduse võtsime kasutades [http://www.asp.net/web-api/overview/security/basic-authentication näidist veebis], kus on ära toodud ka antud lahenduse plussid ja miinused. Parooli räsi hoiame andmebaasis. Räsi genereerimiseks kasutasime [http://crackstation.net/hashing-security.htm veebis asuvat moodulit].

=== Veebiteenuse retsensioon meeskonna Leemur poolt ===

====1. töö vastavus esitatud tingimustele====

Töö täielikult esitatud tingimustele ei vasta, kuna kolmest alamülesandest on realiseeritud kaks esimest (teenuse pakkumine ning teenuse kasutajate tuvastamine ja haldamine). Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes ei ole töös realiseeritud. Ka kasutajate haldust ei ole väga põhjalikult realiseeritud. Samas see, mis on tehtud teenuse enda osas, on tehtud põhjalikult ja hästi.
Teenuse osa
Loodud on kontrollerid:

'''a. Home – kuvab esilehe'''

'''b. Upload – kuvab pildi üleslaadimise lehe'''

Pildi üleslaadimine aadressilt ~/Upload töötab. http://localhost:55878/Upload - autentisin anonymous kontoga. Muidugi võiks mainida, et lehel ei ole järjekindlust valitud keele rakendamiseks (üksik ’Lehitse’ nupp eesti keeles). Tulemuseks tagastatakse image objekt.

Pärast pildi üles laadimist, saab neid vaadata aadressilt http://localhost:55878/api/OriginalImage/{id}.

'''c. OriginalImage - annab tagasi originaalfaili, kui kasutaja on autoriseeritud'''

Realiseeritud on GET meetod, mis täiesti töötab http://localhost:55878/api/OriginalImage/{id}

'''d. ImageUpload''' – selle kontrolleri mõttest ei saa väga aru. Oleks eeldanud, et see suunab mind ~/Upload lehele. Aadressile ~/ImageUpload minnes sain vastuseks:

{
"$id": "1",
"Message": "The requested resource does not support http method 'GET'."
}

'''e. Thumb - leiab thumbnailsi pildile vastavalt ette antud tüübile small, medium, large ja pildi id'le'''

Realiseeritud on GET meetod, mis töötab ja tagastab pildi valitud suurusele:

http://localhost:55878/api/Thumb?id=1&type=small
http://localhost:55878/api/Thumb?id=1&type=medium
http://localhost:55878/api/Thumb?id=1&type=large

'''f. Image – tagastab image objekti, mis seotud kasutajaga'''

Realiseeritud on GET, PUT ja DELETE meetod. POST meetod suunab upload lehele. GetBy id meetodi miinuseks ütleks, et kui sisestada aadressi http://localhost:55878/api/image/{id} id selline väärtus, mida ei eksisteeri, siis ilmub tühi leht. Võiks olla mingi informatiivne tekst.

'''g. ImageComment - väljastab kõik kasutaja tehtud kommentaarid.'''

Realiseeritud on GET, POST, DELETE ja PUT meetod, mis tagastab MethodNotAllowed teate. Ning DELETE meetod on lubatud ainult administraatorile. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kommentaare muuta.

'''h. ImageCategory – väljastab piltide kategooria loendi,''' stiilis:

{
"$id": "1",
"Images": [],
"ImageCategoryID": 1,
"Name": "Uncategorized"
},
{
"$id": "2",
"Images": [],
"ImageCategoryID": 2,
"Name": "Loodus"
}

GET meetod on kõigile nähtav. Samuti realiseeritud POST, PUT ja DELETE vaid admin kasutajale. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kategooriaid muuta.

'''i. User – tagastab kasutajate loendi,''' stiilis

{
"$id": "1",
"UserID": "admin",
"Password": "1000:Lk6Jg3A+pcP4FRwfVO3VcUKESqyH19R7:I2j8NTisCxPn4/e0YL3zdr/9/xXfhGKk"
},
{
"$id": "2",
"UserID": "aleksandr",
"Password": "1000:FdJ5RNgQIvykcblEWaD576NbI6/ih/uf:ltScbkbx1bo1O0Ag94WjSEOikgJ2P0Sc"

}

Realiseeritud on '''GET ja POST''' meetodid. Iseasi, kas iga kasutaja peaks saama vaadata juba loodud kasutajate kontode andmeid. Ehk peaks ka siia panema administraatori õiguste kontrolli.

Kasutajate autentimise ja halduse osa

Kasutatud on basic autentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Parooli räsi hoitakse andmebaasis.

Kasutajate halduse poolelt on ainukestena realiseeritud User kontroller GET ja POST meetoditega. Ülesande püstituses soovitatut (luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE)) järgitud ei ole. Samas oli see ainult soovitus, mitte nõue.

====2. programmikoodi loetavus ning kommenteeritus====

Koodi ei ole ülemäära palju kommenteeritud, ent olemasolevad kommentaarid on piisavad, et toimuvast aru saada. Testimiseks ja retsenseerimiseks täiesti piisavad. Kood on loetav ja arusaadav.

====3. dokumentatsiooni olemasolu====

Eraldi dokumentatsiooni veebiteenusele lisatud ei ole. Samas ei ole see ka kusagil eraldi nõutud, seega otseselt miinuseks lugeda ei saa.

====4. kirjeldada puudusi====

Teenuse kasutajate ja kasutusstatistika üle arve pidamist ei toimu. Ka kasutajate halduse pool on ilmselt kiirustades realiseeritud. Põhjuseks tõenäoliselt
piiratud ajaressurss. Administraatori õigustega toimingute kontroll on kindlasti vaja ümber teha ja täiendada.

== Ülesanne 3 - Klient ==
Tähtaeg 10.06.2013
=== Windows phone 8 rakendus ===
[http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-06-10.zip PictureSolution_2013-06-10.zip]
* kasutatud ainult avalikke api teenuste komponente
* CRUD operatsioonidest ainult R.

==== Testimise juhend ====
Eeldused:
* Visual studio 2012
* Windows Phone 8 SDK

Seadistamine, et töötaks kõik kohalikust arvutist.
* Vaata oma arvuti IP-aadress (cmd ja ipconfig)
* Ava IIS-Express seadistusfail %USERPROFILE%\My Documents\IISExpress\config\applicationhost.config
* Määra saidi binding aadressiks localhost asemel oma arvuti IP-aadress. Juhul kui seda ei ole, käivita korra projekt.
<site name="PictureWebAPI" id="10">
<application path="/" applicationPool="Clr4IntegratedAppPool">
<virtualDirectory path="/" physicalPath="C:\DEV\PildiportaalWebAPI\PictureSolution\PictureWebAPI" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:55878:192.168.2.100" />
</bindings>
* Ava Projekti PictureWebAPI Seadistused (parem klõps ja properties)
* Määra "Project Url" väärtuseks: http://[IP-aadress]:55878/, näiteks "http://192.168.2.100:55878/"
* Määra WP8PicturePanorama projektis asuvas App.xaml.cs klassis parameetri APIBaseURL väärtuseks "http://[IP-aadress]:55878/"
* käivita käsurida admin õigustega, käsurealt: C:\Program Files\IIS Express>iisexpress.exe /site:"PictureWebAPI"
* Käivita WP8PicturePanorama projekt.
* Vajadusel ava tulemüüri port 55878

Terav C - Võrgurakendused 2 - projektileht

2013-06-10T21:29:06Z

Atsernik: /* Windows phone 8 rakendus */

== Üldist ==
=== Liikmed ===
* Aleksandr Laidoner
* Oliver Dalberg
* Tarmo Sillajõe
* Andre Tšernikov

=== Teema valik - Pildiportaal ===
Valisime teemaks pildiportaali.

== Ülesanne 1 - XML ==
Tähtaeg 15.04.2013
=== XML - fail ===
Antud xml'i annab välja Pildiportaali veebiteenus selleks, et kliendid saaks kuvada galerii infot.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii.xml TeravC-galerii.xml]

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<galeriid>
<galerii id="1" kategooria="Loomad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="KB">200</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="3" vaade="suur">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">3</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="4" vaade="ikoon">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>png</formaat>
<suurus yhik="KB">230</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
<galerii id="2" kategooria="Linnad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>raw</formaat>
<suurus yhik="KB">220</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
</galeriid>

</source>

=== XSL - stiilifailid ===

==== Stiilifail 1 - inimsõbralik vaade xml faili sisust ====
Antud stiilifail vormindab inimsõbralikul tabeli kujul ülaloleva XML'i
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html1.xslt TeravC-galerii-xsl-html1.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>XML to HTML 1</title>
<style>
.theader { font-style:italic; text-decoration:underline; }
</style>

</head>
<body>
<H1>getPildid sõnumi sisu.</H1>
<xsl:for-each select="/galeriid/galerii">
<h3>
<xsl:text>Galerii nr. </xsl:text>
<xsl:value-of select="@id"/>
<xsl:text> (</xsl:text>
<xsl:value-of select="@kategooria"/>
<xsl:text>)</xsl:text>
</h3>
<table>
<tr class="theader">
<td>pilt.number</td>
<td>pilt.vaade</td>
<td>nimi</td>
<td>kirjeldus</td>
<td>formaat</td>
<td>suurus</td>
</tr>
<xsl:for-each select ="pildid/pilt">
<tr>
<td>
<xsl:value-of select="@number"/>
</td>
<td>
<xsl:value-of select="@vaade"/>
</td>
<td>
<xsl:value-of select="nimi"/>
</td>
<td>
<xsl:value-of select="kirjeldus"/>
</td>
<td>
<xsl:value-of select="formaat"/>
</td>
<td>
<xsl:value-of select="suurus"/>
<xsl:value-of select="suurus/@yhik"/>
</td>
</tr>
</xsl:for-each>
</table>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>

</source>

==== Stiilifail 2 - galerii vaade (ikoonid) ====
Antud stiilifail vormindab XML'i galeriilaadseks HTML'iks
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html2.xslt TeravC-galerii-xsl-html2.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>XML to HTML - Gallery</title>
<style>
div.img
{
margin: 2px;
border: 1px solid #0000ff;
height: auto;
width: auto;
float: left;
text-align: center;
}
div.img img
{
display: inline;
margin: 3px;
border: 1px solid #ffffff;
}
div.img a:hover img {border: 1px solid #0000ff;}
div.desc
{
text-align: center;
font-weight: normal;
width: 120px;
margin: 2px;
}
</style>

</head>
<body>
<xsl:for-each select="/galeriid/galerii">
<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<div class="img">
<a target="_blank" href="#">
<img
src="http://fc09.deviantart.net/fs6/i/2005/039/d/c/Not_Available_Icon_by_blacxthornE.jpg"
width="110"
height="90"/>

</a>
<div class="desc">
<xsl:value-of select="kirjeldus"/>
</div>
</div>
</xsl:if>
</xsl:for-each>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>
</source>

==== Stiilifail 3 - thumbnails xml ====
Antud stiilifail vormindab xml'i ringi selliselt, et kuvab masinsõbralikul kujul xml'i.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-xml.xslt TeravC-galerii-xsl-xml.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<thumbnails>

<xsl:for-each select="/galeriid/galerii">

<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<thumb>
<xsl:attribute name="number">
<xsl:value-of select="@number"/>
</xsl:attribute>
<nimi>
<xsl:value-of select="nimi"/>
</nimi>
<kirjeldus>
<xsl:value-of select="kirjeldus"/>
</kirjeldus>
<url>
<xsl:text>http://pildiportaal.mingidomeen.ee/getThumb.aspx?id=</xsl:text>
<xsl:value-of select="@number"/>
</url>
<lisatud>
<xsl:value-of select="lisatud/aasta"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/kuu"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/paev"/>
</lisatud>
</thumb>

</xsl:if>
</xsl:for-each>
</xsl:for-each>

</thumbnails>
</xsl:template>
</xsl:stylesheet>

</source>

=== Skeemifail ===
Antud skeemifail mõeldud ülalova ning sellelaadse xml faili valideerimiseks
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="yhikuTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="KB"/>
<xs:enumeration value="MB"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="vaateTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="ikoon"/>
<xs:enumeration value="suur"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="kategooriaTyyp">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][a-z]+"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="galeriid">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="galerii">
<xs:complexType>
<xs:sequence>
<xs:element name="pildid">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="200" name="pilt">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string" />
<xs:element name="kirjeldus" type="xs:string" />
<xs:element name="formaat" type="xs:string" />
<xs:element name="suurus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:unsignedInt">
<xs:attribute name="yhik" type="yhikuTyyp" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="lisatud">
<xs:complexType>
<xs:sequence>
<xs:element name="paev" type="xs:unsignedByte"/>
<xs:element name="kuu" type="xs:unsignedByte"/>
<xs:element name="aasta" type="xs:unsignedShort"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="number" type="xs:unsignedInt" use="required" />
<xs:attribute name="vaade" type="vaateTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="kategooria" type="kategooriaTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</source>

== Retsensioonid ==
XML

Kodutööna on loodud xml fail pildiportaali veebiteenuse välja andmiseks. Pildiportaal on mõeldud klientidele galerii info kuvamiseks. Xml failis on 6 loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat kui lihtsalt id. Lisaks on loodud ka xsd vormingus skeemifail xml faili valideerimiseks. Xml failile on loodud ka 3 xslt stiilifaili: esimene neist annab välja html vormingus tabeli – tabelis on toodud iga pildi number, vaade, nimi, kirjeldus, vormingu ning suuruse andmed. Lisaks on pildid tabelitesse jaotatud kategooriate järgi ning galeriid on ka nummerdatud; teise stiilifaili eesmärk on algse xml faili andmetest vormindada galeriilaadne html, mida see stiilifail ka teeb; kolmas stiilifail vormindab algse xml-i ringi selliselt, et kuvab masinsõbralikul kujul xml'i pildi nime, kirjelduse, url aadressi ning lisamise kuupäeva andmetega. Kodutöö vastab seega täielikult esitatud tingimustele.

Kood otseselt kommenteeritud ei ole, aga see-eest on iga faili üldotstarve välja toodud meeskonna wiki lehel iga konkreetse faili juures. Samuti on kood loetav ja arusaadav.

Dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga see ei olnud ka nõutud kodutöö ülesande püstituses. Seega ei saa seda lugeda tehtud töö puuduseks hindamise mõttes. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba praegu dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena tooks ehk välja, et pildi juures ei ole pildi lisaja või tegija andmeid. Tänases päevas on igasugused autoriõigused väga kuum teema.

Meeskond Leemur

== XML retsensioon ==

Esitatud xml’i peaks genereerima Pildiportaali veebiteenus. XML vastab igati kodutöö nõuetes kirjeldatud tingimustele: xml sisaldab kuus loogilist dimensiooni ja kasutatud on piisavalt atribuute. Sisu on igati loogiline, ehk oleks võinud ainult lisada veel ühe dimensiooni ja viia eraldi gruppidesse nö „ikoonid“ ja „suured“ pildid aga eks see on ka suuresti maitse asi.

Esimene xslt fail andis tulemuseks html kujul ilusa tabeli galeriides olevatest piltidest, näha on, et autorid olid sellega ka vaeva näinud ja kenasti tulemuse ära formaatinud. Teine xslt annab juba html kujul galeriivaate ikoonidest, mis on ka valmisolekuga lisada sinna link suuremale pildile (hetkel veel puudub aga pole ka selle ülesande skoobi mõttes oluline). Kolmas xslt moodustab algsest xml-st uue spetsiifilisema xml faili. Teeb seda päris kenasti, aga url-i leidmisel tekib väike viga. Nimelt ei ole seal arvestatud mitme galerii olemasoluga, kus id-sid alustatakse ühest alates. See on tekitanud selle, et url kahe erineva galerii piltidele sama id-ga on sisult identsed. Antud ülesande mõttes seda veaks ei loeks, kuna tehniliselt kõik toimib aga kui hilisemas faasis ka seda kasutada saab, siis peaks natuke xslt skripti täiendama.

Kokkuvõtteks võib öelda, et meeskond TeravC XML kodutöö vastab kõigile esitatud nõuetele ja on hästi teostatud. Kõik esitatud failid ka valideerusid.

Meeskond Hops

== Ülesanne 2 - Veebiteenus ==
Tähtaeg 20.05.2013

=== Web API lahendus 2013-05-20 ===
*Esmalt vabandame kõigi retsenseerijate ees - ei jõudnud väga testida.Kood on kättesaadav: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-20.zip PictureSolution_2013-05-20.zip]
*Õppejõule ligipääasetav TFS projekt: [https://oliverd.visualstudio.com https://oliverd.visualstudio.com]
* Lisandus 26.05.2013 silutud ja ilusamaks tehtud: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-26.zip PictureSolution_2013-05-26.zip]
==== Testiabi ====
===== Pildi loomine =====
* Uue pildi tekitamiseks tuleb laadida pilt ülesse. Selleks kasuta Upload Controllerit (~/Upload). Kasutaja ja parooli saab spikerdada PictureDAL -> Migrations -> Configurations.cs.
* ImageUpload api-controller annab tagasi Image tüüpi objekti, mida siis saab sisse süüa, vajaduse täiendada, ning PUT käsuga uuendada serveris (Kasutades nüüd juba Image api-controllerit)

===== Uue objekti loomine =====
Näiteks uue kommentaari lisamiseks kasuta alljärgnevat päringud fiddleris:
POST http://localhost:55878/api/imagecomment HTTP/1.1
Host: localhost:55878
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Authorization: Basic YWRtaW46c2VjcmV0

{
"ImageID": 1,
"Comment": "Comment 2, hinne 6",
"Rating": 6,
}

==== Audentimisest ====
Kasutame basic-audentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Lahenduse võtsime kasutades [http://www.asp.net/web-api/overview/security/basic-authentication näidist veebis], kus on ära toodud ka antud lahenduse plussid ja miinused. Parooli räsi hoiame andmebaasis. Räsi genereerimiseks kasutasime [http://crackstation.net/hashing-security.htm veebis asuvat moodulit].

=== Veebiteenuse retsensioon meeskonna Leemur poolt ===

====1. töö vastavus esitatud tingimustele====

Töö täielikult esitatud tingimustele ei vasta, kuna kolmest alamülesandest on realiseeritud kaks esimest (teenuse pakkumine ning teenuse kasutajate tuvastamine ja haldamine). Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes ei ole töös realiseeritud. Ka kasutajate haldust ei ole väga põhjalikult realiseeritud. Samas see, mis on tehtud teenuse enda osas, on tehtud põhjalikult ja hästi.
Teenuse osa
Loodud on kontrollerid:

'''a. Home – kuvab esilehe'''

'''b. Upload – kuvab pildi üleslaadimise lehe'''

Pildi üleslaadimine aadressilt ~/Upload töötab. http://localhost:55878/Upload - autentisin anonymous kontoga. Muidugi võiks mainida, et lehel ei ole järjekindlust valitud keele rakendamiseks (üksik ’Lehitse’ nupp eesti keeles). Tulemuseks tagastatakse image objekt.

Pärast pildi üles laadimist, saab neid vaadata aadressilt http://localhost:55878/api/OriginalImage/{id}.

'''c. OriginalImage - annab tagasi originaalfaili, kui kasutaja on autoriseeritud'''

Realiseeritud on GET meetod, mis täiesti töötab http://localhost:55878/api/OriginalImage/{id}

'''d. ImageUpload''' – selle kontrolleri mõttest ei saa väga aru. Oleks eeldanud, et see suunab mind ~/Upload lehele. Aadressile ~/ImageUpload minnes sain vastuseks:

{
"$id": "1",
"Message": "The requested resource does not support http method 'GET'."
}

'''e. Thumb - leiab thumbnailsi pildile vastavalt ette antud tüübile small, medium, large ja pildi id'le'''

Realiseeritud on GET meetod, mis töötab ja tagastab pildi valitud suurusele:

http://localhost:55878/api/Thumb?id=1&type=small
http://localhost:55878/api/Thumb?id=1&type=medium
http://localhost:55878/api/Thumb?id=1&type=large

'''f. Image – tagastab image objekti, mis seotud kasutajaga'''

Realiseeritud on GET, PUT ja DELETE meetod. POST meetod suunab upload lehele. GetBy id meetodi miinuseks ütleks, et kui sisestada aadressi http://localhost:55878/api/image/{id} id selline väärtus, mida ei eksisteeri, siis ilmub tühi leht. Võiks olla mingi informatiivne tekst.

'''g. ImageComment - väljastab kõik kasutaja tehtud kommentaarid.'''

Realiseeritud on GET, POST, DELETE ja PUT meetod, mis tagastab MethodNotAllowed teate. Ning DELETE meetod on lubatud ainult administraatorile. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kommentaare muuta.

'''h. ImageCategory – väljastab piltide kategooria loendi,''' stiilis:

{
"$id": "1",
"Images": [],
"ImageCategoryID": 1,
"Name": "Uncategorized"
},
{
"$id": "2",
"Images": [],
"ImageCategoryID": 2,
"Name": "Loodus"
}

GET meetod on kõigile nähtav. Samuti realiseeritud POST, PUT ja DELETE vaid admin kasutajale. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kategooriaid muuta.

'''i. User – tagastab kasutajate loendi,''' stiilis

{
"$id": "1",
"UserID": "admin",
"Password": "1000:Lk6Jg3A+pcP4FRwfVO3VcUKESqyH19R7:I2j8NTisCxPn4/e0YL3zdr/9/xXfhGKk"
},
{
"$id": "2",
"UserID": "aleksandr",
"Password": "1000:FdJ5RNgQIvykcblEWaD576NbI6/ih/uf:ltScbkbx1bo1O0Ag94WjSEOikgJ2P0Sc"

}

Realiseeritud on '''GET ja POST''' meetodid. Iseasi, kas iga kasutaja peaks saama vaadata juba loodud kasutajate kontode andmeid. Ehk peaks ka siia panema administraatori õiguste kontrolli.

Kasutajate autentimise ja halduse osa

Kasutatud on basic autentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Parooli räsi hoitakse andmebaasis.

Kasutajate halduse poolelt on ainukestena realiseeritud User kontroller GET ja POST meetoditega. Ülesande püstituses soovitatut (luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE)) järgitud ei ole. Samas oli see ainult soovitus, mitte nõue.

====2. programmikoodi loetavus ning kommenteeritus====

Koodi ei ole ülemäära palju kommenteeritud, ent olemasolevad kommentaarid on piisavad, et toimuvast aru saada. Testimiseks ja retsenseerimiseks täiesti piisavad. Kood on loetav ja arusaadav.

====3. dokumentatsiooni olemasolu====

Eraldi dokumentatsiooni veebiteenusele lisatud ei ole. Samas ei ole see ka kusagil eraldi nõutud, seega otseselt miinuseks lugeda ei saa.

====4. kirjeldada puudusi====

Teenuse kasutajate ja kasutusstatistika üle arve pidamist ei toimu. Ka kasutajate halduse pool on ilmselt kiirustades realiseeritud. Põhjuseks tõenäoliselt
piiratud ajaressurss. Administraatori õigustega toimingute kontroll on kindlasti vaja ümber teha ja täiendada.

== Ülesanne 3 - Klient ==
Tähtaeg 10.06.2013
=== Windows phone 8 rakendus ===
[http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-06-10.zip PictureSolution_2013-06-10.zip]
==== Testimise juhend ====
Eeldused:
* Visual studio 2012
* Windows Phone 8 SDK

Seadistamine, et töötaks kõik kohalikust arvutist.
* Vaata oma arvuti IP-aadress (cmd ja ipconfig)
* Ava IIS-Express seadistusfail %USERPROFILE%\My Documents\IISExpress\config\applicationhost.config
* Määra saidi binding aadressiks localhost asemel oma arvuti IP-aadress. Juhul kui seda ei ole, käivita korra projekt.
<site name="PictureWebAPI" id="10">
<application path="/" applicationPool="Clr4IntegratedAppPool">
<virtualDirectory path="/" physicalPath="C:\DEV\PildiportaalWebAPI\PictureSolution\PictureWebAPI" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:55878:192.168.2.100" />
</bindings>
* Ava Projekti PictureWebAPI Seadistused (parem klõps ja properties)
* Määra "Project Url" väärtuseks: http://[IP-aadress]:55878/, näiteks "http://192.168.2.100:55878/"
* Määra WP8PicturePanorama projektis asuvas App.xaml.cs klassis parameetri APIBaseURL väärtuseks "http://[IP-aadress]:55878/"
* käivita käsurida admin õigustega, käsurealt: C:\Program Files\IIS Express>iisexpress.exe /site:"PictureWebAPI"
* Käivita WP8PicturePanorama projekt.
* Vajadusel ava tulemüüri port 55878

Terav C - Võrgurakendused 2 - projektileht

2013-06-10T21:28:41Z

Atsernik: /* Windows phone 8 rakendus */

== Üldist ==
=== Liikmed ===
* Aleksandr Laidoner
* Oliver Dalberg
* Tarmo Sillajõe
* Andre Tšernikov

=== Teema valik - Pildiportaal ===
Valisime teemaks pildiportaali.

== Ülesanne 1 - XML ==
Tähtaeg 15.04.2013
=== XML - fail ===
Antud xml'i annab välja Pildiportaali veebiteenus selleks, et kliendid saaks kuvada galerii infot.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii.xml TeravC-galerii.xml]

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<galeriid>
<galerii id="1" kategooria="Loomad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="KB">200</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="3" vaade="suur">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">3</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="4" vaade="ikoon">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>png</formaat>
<suurus yhik="KB">230</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
<galerii id="2" kategooria="Linnad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>raw</formaat>
<suurus yhik="KB">220</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
</galeriid>

</source>

=== XSL - stiilifailid ===

==== Stiilifail 1 - inimsõbralik vaade xml faili sisust ====
Antud stiilifail vormindab inimsõbralikul tabeli kujul ülaloleva XML'i
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html1.xslt TeravC-galerii-xsl-html1.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>XML to HTML 1</title>
<style>
.theader { font-style:italic; text-decoration:underline; }
</style>

</head>
<body>
<H1>getPildid sõnumi sisu.</H1>
<xsl:for-each select="/galeriid/galerii">
<h3>
<xsl:text>Galerii nr. </xsl:text>
<xsl:value-of select="@id"/>
<xsl:text> (</xsl:text>
<xsl:value-of select="@kategooria"/>
<xsl:text>)</xsl:text>
</h3>
<table>
<tr class="theader">
<td>pilt.number</td>
<td>pilt.vaade</td>
<td>nimi</td>
<td>kirjeldus</td>
<td>formaat</td>
<td>suurus</td>
</tr>
<xsl:for-each select ="pildid/pilt">
<tr>
<td>
<xsl:value-of select="@number"/>
</td>
<td>
<xsl:value-of select="@vaade"/>
</td>
<td>
<xsl:value-of select="nimi"/>
</td>
<td>
<xsl:value-of select="kirjeldus"/>
</td>
<td>
<xsl:value-of select="formaat"/>
</td>
<td>
<xsl:value-of select="suurus"/>
<xsl:value-of select="suurus/@yhik"/>
</td>
</tr>
</xsl:for-each>
</table>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>

</source>

==== Stiilifail 2 - galerii vaade (ikoonid) ====
Antud stiilifail vormindab XML'i galeriilaadseks HTML'iks
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html2.xslt TeravC-galerii-xsl-html2.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>XML to HTML - Gallery</title>
<style>
div.img
{
margin: 2px;
border: 1px solid #0000ff;
height: auto;
width: auto;
float: left;
text-align: center;
}
div.img img
{
display: inline;
margin: 3px;
border: 1px solid #ffffff;
}
div.img a:hover img {border: 1px solid #0000ff;}
div.desc
{
text-align: center;
font-weight: normal;
width: 120px;
margin: 2px;
}
</style>

</head>
<body>
<xsl:for-each select="/galeriid/galerii">
<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<div class="img">
<a target="_blank" href="#">
<img
src="http://fc09.deviantart.net/fs6/i/2005/039/d/c/Not_Available_Icon_by_blacxthornE.jpg"
width="110"
height="90"/>

</a>
<div class="desc">
<xsl:value-of select="kirjeldus"/>
</div>
</div>
</xsl:if>
</xsl:for-each>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>
</source>

==== Stiilifail 3 - thumbnails xml ====
Antud stiilifail vormindab xml'i ringi selliselt, et kuvab masinsõbralikul kujul xml'i.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-xml.xslt TeravC-galerii-xsl-xml.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<thumbnails>

<xsl:for-each select="/galeriid/galerii">

<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<thumb>
<xsl:attribute name="number">
<xsl:value-of select="@number"/>
</xsl:attribute>
<nimi>
<xsl:value-of select="nimi"/>
</nimi>
<kirjeldus>
<xsl:value-of select="kirjeldus"/>
</kirjeldus>
<url>
<xsl:text>http://pildiportaal.mingidomeen.ee/getThumb.aspx?id=</xsl:text>
<xsl:value-of select="@number"/>
</url>
<lisatud>
<xsl:value-of select="lisatud/aasta"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/kuu"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/paev"/>
</lisatud>
</thumb>

</xsl:if>
</xsl:for-each>
</xsl:for-each>

</thumbnails>
</xsl:template>
</xsl:stylesheet>

</source>

=== Skeemifail ===
Antud skeemifail mõeldud ülalova ning sellelaadse xml faili valideerimiseks
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="yhikuTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="KB"/>
<xs:enumeration value="MB"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="vaateTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="ikoon"/>
<xs:enumeration value="suur"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="kategooriaTyyp">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][a-z]+"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="galeriid">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="galerii">
<xs:complexType>
<xs:sequence>
<xs:element name="pildid">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="200" name="pilt">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string" />
<xs:element name="kirjeldus" type="xs:string" />
<xs:element name="formaat" type="xs:string" />
<xs:element name="suurus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:unsignedInt">
<xs:attribute name="yhik" type="yhikuTyyp" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="lisatud">
<xs:complexType>
<xs:sequence>
<xs:element name="paev" type="xs:unsignedByte"/>
<xs:element name="kuu" type="xs:unsignedByte"/>
<xs:element name="aasta" type="xs:unsignedShort"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="number" type="xs:unsignedInt" use="required" />
<xs:attribute name="vaade" type="vaateTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="kategooria" type="kategooriaTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</source>

== Retsensioonid ==
XML

Kodutööna on loodud xml fail pildiportaali veebiteenuse välja andmiseks. Pildiportaal on mõeldud klientidele galerii info kuvamiseks. Xml failis on 6 loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat kui lihtsalt id. Lisaks on loodud ka xsd vormingus skeemifail xml faili valideerimiseks. Xml failile on loodud ka 3 xslt stiilifaili: esimene neist annab välja html vormingus tabeli – tabelis on toodud iga pildi number, vaade, nimi, kirjeldus, vormingu ning suuruse andmed. Lisaks on pildid tabelitesse jaotatud kategooriate järgi ning galeriid on ka nummerdatud; teise stiilifaili eesmärk on algse xml faili andmetest vormindada galeriilaadne html, mida see stiilifail ka teeb; kolmas stiilifail vormindab algse xml-i ringi selliselt, et kuvab masinsõbralikul kujul xml'i pildi nime, kirjelduse, url aadressi ning lisamise kuupäeva andmetega. Kodutöö vastab seega täielikult esitatud tingimustele.

Kood otseselt kommenteeritud ei ole, aga see-eest on iga faili üldotstarve välja toodud meeskonna wiki lehel iga konkreetse faili juures. Samuti on kood loetav ja arusaadav.

Dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga see ei olnud ka nõutud kodutöö ülesande püstituses. Seega ei saa seda lugeda tehtud töö puuduseks hindamise mõttes. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba praegu dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena tooks ehk välja, et pildi juures ei ole pildi lisaja või tegija andmeid. Tänases päevas on igasugused autoriõigused väga kuum teema.

Meeskond Leemur

== XML retsensioon ==

Esitatud xml’i peaks genereerima Pildiportaali veebiteenus. XML vastab igati kodutöö nõuetes kirjeldatud tingimustele: xml sisaldab kuus loogilist dimensiooni ja kasutatud on piisavalt atribuute. Sisu on igati loogiline, ehk oleks võinud ainult lisada veel ühe dimensiooni ja viia eraldi gruppidesse nö „ikoonid“ ja „suured“ pildid aga eks see on ka suuresti maitse asi.

Esimene xslt fail andis tulemuseks html kujul ilusa tabeli galeriides olevatest piltidest, näha on, et autorid olid sellega ka vaeva näinud ja kenasti tulemuse ära formaatinud. Teine xslt annab juba html kujul galeriivaate ikoonidest, mis on ka valmisolekuga lisada sinna link suuremale pildile (hetkel veel puudub aga pole ka selle ülesande skoobi mõttes oluline). Kolmas xslt moodustab algsest xml-st uue spetsiifilisema xml faili. Teeb seda päris kenasti, aga url-i leidmisel tekib väike viga. Nimelt ei ole seal arvestatud mitme galerii olemasoluga, kus id-sid alustatakse ühest alates. See on tekitanud selle, et url kahe erineva galerii piltidele sama id-ga on sisult identsed. Antud ülesande mõttes seda veaks ei loeks, kuna tehniliselt kõik toimib aga kui hilisemas faasis ka seda kasutada saab, siis peaks natuke xslt skripti täiendama.

Kokkuvõtteks võib öelda, et meeskond TeravC XML kodutöö vastab kõigile esitatud nõuetele ja on hästi teostatud. Kõik esitatud failid ka valideerusid.

Meeskond Hops

== Ülesanne 2 - Veebiteenus ==
Tähtaeg 20.05.2013

=== Web API lahendus 2013-05-20 ===
*Esmalt vabandame kõigi retsenseerijate ees - ei jõudnud väga testida.Kood on kättesaadav: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-20.zip PictureSolution_2013-05-20.zip]
*Õppejõule ligipääasetav TFS projekt: [https://oliverd.visualstudio.com https://oliverd.visualstudio.com]
* Lisandus 26.05.2013 silutud ja ilusamaks tehtud: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-26.zip PictureSolution_2013-05-26.zip]
==== Testiabi ====
===== Pildi loomine =====
* Uue pildi tekitamiseks tuleb laadida pilt ülesse. Selleks kasuta Upload Controllerit (~/Upload). Kasutaja ja parooli saab spikerdada PictureDAL -> Migrations -> Configurations.cs.
* ImageUpload api-controller annab tagasi Image tüüpi objekti, mida siis saab sisse süüa, vajaduse täiendada, ning PUT käsuga uuendada serveris (Kasutades nüüd juba Image api-controllerit)

===== Uue objekti loomine =====
Näiteks uue kommentaari lisamiseks kasuta alljärgnevat päringud fiddleris:
POST http://localhost:55878/api/imagecomment HTTP/1.1
Host: localhost:55878
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Authorization: Basic YWRtaW46c2VjcmV0

{
"ImageID": 1,
"Comment": "Comment 2, hinne 6",
"Rating": 6,
}

==== Audentimisest ====
Kasutame basic-audentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Lahenduse võtsime kasutades [http://www.asp.net/web-api/overview/security/basic-authentication näidist veebis], kus on ära toodud ka antud lahenduse plussid ja miinused. Parooli räsi hoiame andmebaasis. Räsi genereerimiseks kasutasime [http://crackstation.net/hashing-security.htm veebis asuvat moodulit].

=== Veebiteenuse retsensioon meeskonna Leemur poolt ===

====1. töö vastavus esitatud tingimustele====

Töö täielikult esitatud tingimustele ei vasta, kuna kolmest alamülesandest on realiseeritud kaks esimest (teenuse pakkumine ning teenuse kasutajate tuvastamine ja haldamine). Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes ei ole töös realiseeritud. Ka kasutajate haldust ei ole väga põhjalikult realiseeritud. Samas see, mis on tehtud teenuse enda osas, on tehtud põhjalikult ja hästi.
Teenuse osa
Loodud on kontrollerid:

'''a. Home – kuvab esilehe'''

'''b. Upload – kuvab pildi üleslaadimise lehe'''

Pildi üleslaadimine aadressilt ~/Upload töötab. http://localhost:55878/Upload - autentisin anonymous kontoga. Muidugi võiks mainida, et lehel ei ole järjekindlust valitud keele rakendamiseks (üksik ’Lehitse’ nupp eesti keeles). Tulemuseks tagastatakse image objekt.

Pärast pildi üles laadimist, saab neid vaadata aadressilt http://localhost:55878/api/OriginalImage/{id}.

'''c. OriginalImage - annab tagasi originaalfaili, kui kasutaja on autoriseeritud'''

Realiseeritud on GET meetod, mis täiesti töötab http://localhost:55878/api/OriginalImage/{id}

'''d. ImageUpload''' – selle kontrolleri mõttest ei saa väga aru. Oleks eeldanud, et see suunab mind ~/Upload lehele. Aadressile ~/ImageUpload minnes sain vastuseks:

{
"$id": "1",
"Message": "The requested resource does not support http method 'GET'."
}

'''e. Thumb - leiab thumbnailsi pildile vastavalt ette antud tüübile small, medium, large ja pildi id'le'''

Realiseeritud on GET meetod, mis töötab ja tagastab pildi valitud suurusele:

http://localhost:55878/api/Thumb?id=1&type=small
http://localhost:55878/api/Thumb?id=1&type=medium
http://localhost:55878/api/Thumb?id=1&type=large

'''f. Image – tagastab image objekti, mis seotud kasutajaga'''

Realiseeritud on GET, PUT ja DELETE meetod. POST meetod suunab upload lehele. GetBy id meetodi miinuseks ütleks, et kui sisestada aadressi http://localhost:55878/api/image/{id} id selline väärtus, mida ei eksisteeri, siis ilmub tühi leht. Võiks olla mingi informatiivne tekst.

'''g. ImageComment - väljastab kõik kasutaja tehtud kommentaarid.'''

Realiseeritud on GET, POST, DELETE ja PUT meetod, mis tagastab MethodNotAllowed teate. Ning DELETE meetod on lubatud ainult administraatorile. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kommentaare muuta.

'''h. ImageCategory – väljastab piltide kategooria loendi,''' stiilis:

{
"$id": "1",
"Images": [],
"ImageCategoryID": 1,
"Name": "Uncategorized"
},
{
"$id": "2",
"Images": [],
"ImageCategoryID": 2,
"Name": "Loodus"
}

GET meetod on kõigile nähtav. Samuti realiseeritud POST, PUT ja DELETE vaid admin kasutajale. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kategooriaid muuta.

'''i. User – tagastab kasutajate loendi,''' stiilis

{
"$id": "1",
"UserID": "admin",
"Password": "1000:Lk6Jg3A+pcP4FRwfVO3VcUKESqyH19R7:I2j8NTisCxPn4/e0YL3zdr/9/xXfhGKk"
},
{
"$id": "2",
"UserID": "aleksandr",
"Password": "1000:FdJ5RNgQIvykcblEWaD576NbI6/ih/uf:ltScbkbx1bo1O0Ag94WjSEOikgJ2P0Sc"

}

Realiseeritud on '''GET ja POST''' meetodid. Iseasi, kas iga kasutaja peaks saama vaadata juba loodud kasutajate kontode andmeid. Ehk peaks ka siia panema administraatori õiguste kontrolli.

Kasutajate autentimise ja halduse osa

Kasutatud on basic autentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Parooli räsi hoitakse andmebaasis.

Kasutajate halduse poolelt on ainukestena realiseeritud User kontroller GET ja POST meetoditega. Ülesande püstituses soovitatut (luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE)) järgitud ei ole. Samas oli see ainult soovitus, mitte nõue.

====2. programmikoodi loetavus ning kommenteeritus====

Koodi ei ole ülemäära palju kommenteeritud, ent olemasolevad kommentaarid on piisavad, et toimuvast aru saada. Testimiseks ja retsenseerimiseks täiesti piisavad. Kood on loetav ja arusaadav.

====3. dokumentatsiooni olemasolu====

Eraldi dokumentatsiooni veebiteenusele lisatud ei ole. Samas ei ole see ka kusagil eraldi nõutud, seega otseselt miinuseks lugeda ei saa.

====4. kirjeldada puudusi====

Teenuse kasutajate ja kasutusstatistika üle arve pidamist ei toimu. Ka kasutajate halduse pool on ilmselt kiirustades realiseeritud. Põhjuseks tõenäoliselt
piiratud ajaressurss. Administraatori õigustega toimingute kontroll on kindlasti vaja ümber teha ja täiendada.

== Ülesanne 3 - Klient ==
Tähtaeg 10.06.2013
=== Windows phone 8 rakendus ===
[http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-20.zip PictureSolution_2013-05-20.zip]
==== Testimise juhend ====
Eeldused:
* Visual studio 2012
* Windows Phone 8 SDK

Seadistamine, et töötaks kõik kohalikust arvutist.
* Vaata oma arvuti IP-aadress (cmd ja ipconfig)
* Ava IIS-Express seadistusfail %USERPROFILE%\My Documents\IISExpress\config\applicationhost.config
* Määra saidi binding aadressiks localhost asemel oma arvuti IP-aadress. Juhul kui seda ei ole, käivita korra projekt.
<site name="PictureWebAPI" id="10">
<application path="/" applicationPool="Clr4IntegratedAppPool">
<virtualDirectory path="/" physicalPath="C:\DEV\PildiportaalWebAPI\PictureSolution\PictureWebAPI" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:55878:192.168.2.100" />
</bindings>
* Ava Projekti PictureWebAPI Seadistused (parem klõps ja properties)
* Määra "Project Url" väärtuseks: http://[IP-aadress]:55878/, näiteks "http://192.168.2.100:55878/"
* Määra WP8PicturePanorama projektis asuvas App.xaml.cs klassis parameetri APIBaseURL väärtuseks "http://[IP-aadress]:55878/"
* käivita käsurida admin õigustega, käsurealt: C:\Program Files\IIS Express>iisexpress.exe /site:"PictureWebAPI"
* Käivita WP8PicturePanorama projekt.
* Vajadusel ava tulemüüri port 55878

Terav C - Võrgurakendused 2 - projektileht

2013-06-10T21:21:09Z

Atsernik: /* Testimise juhend */

== Üldist ==
=== Liikmed ===
* Aleksandr Laidoner
* Oliver Dalberg
* Tarmo Sillajõe
* Andre Tšernikov

=== Teema valik - Pildiportaal ===
Valisime teemaks pildiportaali.

== Ülesanne 1 - XML ==
Tähtaeg 15.04.2013
=== XML - fail ===
Antud xml'i annab välja Pildiportaali veebiteenus selleks, et kliendid saaks kuvada galerii infot.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii.xml TeravC-galerii.xml]

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<galeriid>
<galerii id="1" kategooria="Loomad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="KB">200</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="3" vaade="suur">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">3</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="4" vaade="ikoon">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>png</formaat>
<suurus yhik="KB">230</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
<galerii id="2" kategooria="Linnad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>raw</formaat>
<suurus yhik="KB">220</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
</galeriid>

</source>

=== XSL - stiilifailid ===

==== Stiilifail 1 - inimsõbralik vaade xml faili sisust ====
Antud stiilifail vormindab inimsõbralikul tabeli kujul ülaloleva XML'i
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html1.xslt TeravC-galerii-xsl-html1.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>XML to HTML 1</title>
<style>
.theader { font-style:italic; text-decoration:underline; }
</style>

</head>
<body>
<H1>getPildid sõnumi sisu.</H1>
<xsl:for-each select="/galeriid/galerii">
<h3>
<xsl:text>Galerii nr. </xsl:text>
<xsl:value-of select="@id"/>
<xsl:text> (</xsl:text>
<xsl:value-of select="@kategooria"/>
<xsl:text>)</xsl:text>
</h3>
<table>
<tr class="theader">
<td>pilt.number</td>
<td>pilt.vaade</td>
<td>nimi</td>
<td>kirjeldus</td>
<td>formaat</td>
<td>suurus</td>
</tr>
<xsl:for-each select ="pildid/pilt">
<tr>
<td>
<xsl:value-of select="@number"/>
</td>
<td>
<xsl:value-of select="@vaade"/>
</td>
<td>
<xsl:value-of select="nimi"/>
</td>
<td>
<xsl:value-of select="kirjeldus"/>
</td>
<td>
<xsl:value-of select="formaat"/>
</td>
<td>
<xsl:value-of select="suurus"/>
<xsl:value-of select="suurus/@yhik"/>
</td>
</tr>
</xsl:for-each>
</table>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>

</source>

==== Stiilifail 2 - galerii vaade (ikoonid) ====
Antud stiilifail vormindab XML'i galeriilaadseks HTML'iks
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html2.xslt TeravC-galerii-xsl-html2.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>XML to HTML - Gallery</title>
<style>
div.img
{
margin: 2px;
border: 1px solid #0000ff;
height: auto;
width: auto;
float: left;
text-align: center;
}
div.img img
{
display: inline;
margin: 3px;
border: 1px solid #ffffff;
}
div.img a:hover img {border: 1px solid #0000ff;}
div.desc
{
text-align: center;
font-weight: normal;
width: 120px;
margin: 2px;
}
</style>

</head>
<body>
<xsl:for-each select="/galeriid/galerii">
<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<div class="img">
<a target="_blank" href="#">
<img
src="http://fc09.deviantart.net/fs6/i/2005/039/d/c/Not_Available_Icon_by_blacxthornE.jpg"
width="110"
height="90"/>

</a>
<div class="desc">
<xsl:value-of select="kirjeldus"/>
</div>
</div>
</xsl:if>
</xsl:for-each>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>
</source>

==== Stiilifail 3 - thumbnails xml ====
Antud stiilifail vormindab xml'i ringi selliselt, et kuvab masinsõbralikul kujul xml'i.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-xml.xslt TeravC-galerii-xsl-xml.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<thumbnails>

<xsl:for-each select="/galeriid/galerii">

<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<thumb>
<xsl:attribute name="number">
<xsl:value-of select="@number"/>
</xsl:attribute>
<nimi>
<xsl:value-of select="nimi"/>
</nimi>
<kirjeldus>
<xsl:value-of select="kirjeldus"/>
</kirjeldus>
<url>
<xsl:text>http://pildiportaal.mingidomeen.ee/getThumb.aspx?id=</xsl:text>
<xsl:value-of select="@number"/>
</url>
<lisatud>
<xsl:value-of select="lisatud/aasta"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/kuu"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/paev"/>
</lisatud>
</thumb>

</xsl:if>
</xsl:for-each>
</xsl:for-each>

</thumbnails>
</xsl:template>
</xsl:stylesheet>

</source>

=== Skeemifail ===
Antud skeemifail mõeldud ülalova ning sellelaadse xml faili valideerimiseks
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="yhikuTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="KB"/>
<xs:enumeration value="MB"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="vaateTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="ikoon"/>
<xs:enumeration value="suur"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="kategooriaTyyp">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][a-z]+"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="galeriid">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="galerii">
<xs:complexType>
<xs:sequence>
<xs:element name="pildid">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="200" name="pilt">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string" />
<xs:element name="kirjeldus" type="xs:string" />
<xs:element name="formaat" type="xs:string" />
<xs:element name="suurus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:unsignedInt">
<xs:attribute name="yhik" type="yhikuTyyp" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="lisatud">
<xs:complexType>
<xs:sequence>
<xs:element name="paev" type="xs:unsignedByte"/>
<xs:element name="kuu" type="xs:unsignedByte"/>
<xs:element name="aasta" type="xs:unsignedShort"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="number" type="xs:unsignedInt" use="required" />
<xs:attribute name="vaade" type="vaateTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="kategooria" type="kategooriaTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</source>

== Retsensioonid ==
XML

Kodutööna on loodud xml fail pildiportaali veebiteenuse välja andmiseks. Pildiportaal on mõeldud klientidele galerii info kuvamiseks. Xml failis on 6 loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat kui lihtsalt id. Lisaks on loodud ka xsd vormingus skeemifail xml faili valideerimiseks. Xml failile on loodud ka 3 xslt stiilifaili: esimene neist annab välja html vormingus tabeli – tabelis on toodud iga pildi number, vaade, nimi, kirjeldus, vormingu ning suuruse andmed. Lisaks on pildid tabelitesse jaotatud kategooriate järgi ning galeriid on ka nummerdatud; teise stiilifaili eesmärk on algse xml faili andmetest vormindada galeriilaadne html, mida see stiilifail ka teeb; kolmas stiilifail vormindab algse xml-i ringi selliselt, et kuvab masinsõbralikul kujul xml'i pildi nime, kirjelduse, url aadressi ning lisamise kuupäeva andmetega. Kodutöö vastab seega täielikult esitatud tingimustele.

Kood otseselt kommenteeritud ei ole, aga see-eest on iga faili üldotstarve välja toodud meeskonna wiki lehel iga konkreetse faili juures. Samuti on kood loetav ja arusaadav.

Dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga see ei olnud ka nõutud kodutöö ülesande püstituses. Seega ei saa seda lugeda tehtud töö puuduseks hindamise mõttes. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba praegu dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena tooks ehk välja, et pildi juures ei ole pildi lisaja või tegija andmeid. Tänases päevas on igasugused autoriõigused väga kuum teema.

Meeskond Leemur

== XML retsensioon ==

Esitatud xml’i peaks genereerima Pildiportaali veebiteenus. XML vastab igati kodutöö nõuetes kirjeldatud tingimustele: xml sisaldab kuus loogilist dimensiooni ja kasutatud on piisavalt atribuute. Sisu on igati loogiline, ehk oleks võinud ainult lisada veel ühe dimensiooni ja viia eraldi gruppidesse nö „ikoonid“ ja „suured“ pildid aga eks see on ka suuresti maitse asi.

Esimene xslt fail andis tulemuseks html kujul ilusa tabeli galeriides olevatest piltidest, näha on, et autorid olid sellega ka vaeva näinud ja kenasti tulemuse ära formaatinud. Teine xslt annab juba html kujul galeriivaate ikoonidest, mis on ka valmisolekuga lisada sinna link suuremale pildile (hetkel veel puudub aga pole ka selle ülesande skoobi mõttes oluline). Kolmas xslt moodustab algsest xml-st uue spetsiifilisema xml faili. Teeb seda päris kenasti, aga url-i leidmisel tekib väike viga. Nimelt ei ole seal arvestatud mitme galerii olemasoluga, kus id-sid alustatakse ühest alates. See on tekitanud selle, et url kahe erineva galerii piltidele sama id-ga on sisult identsed. Antud ülesande mõttes seda veaks ei loeks, kuna tehniliselt kõik toimib aga kui hilisemas faasis ka seda kasutada saab, siis peaks natuke xslt skripti täiendama.

Kokkuvõtteks võib öelda, et meeskond TeravC XML kodutöö vastab kõigile esitatud nõuetele ja on hästi teostatud. Kõik esitatud failid ka valideerusid.

Meeskond Hops

== Ülesanne 2 - Veebiteenus ==
Tähtaeg 20.05.2013

=== Web API lahendus 2013-05-20 ===
*Esmalt vabandame kõigi retsenseerijate ees - ei jõudnud väga testida.Kood on kättesaadav: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-20.zip PictureSolution_2013-05-20.zip]
*Õppejõule ligipääasetav TFS projekt: [https://oliverd.visualstudio.com https://oliverd.visualstudio.com]
* Lisandus 26.05.2013 silutud ja ilusamaks tehtud: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-26.zip PictureSolution_2013-05-26.zip]
==== Testiabi ====
===== Pildi loomine =====
* Uue pildi tekitamiseks tuleb laadida pilt ülesse. Selleks kasuta Upload Controllerit (~/Upload). Kasutaja ja parooli saab spikerdada PictureDAL -> Migrations -> Configurations.cs.
* ImageUpload api-controller annab tagasi Image tüüpi objekti, mida siis saab sisse süüa, vajaduse täiendada, ning PUT käsuga uuendada serveris (Kasutades nüüd juba Image api-controllerit)

===== Uue objekti loomine =====
Näiteks uue kommentaari lisamiseks kasuta alljärgnevat päringud fiddleris:
POST http://localhost:55878/api/imagecomment HTTP/1.1
Host: localhost:55878
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Authorization: Basic YWRtaW46c2VjcmV0

{
"ImageID": 1,
"Comment": "Comment 2, hinne 6",
"Rating": 6,
}

==== Audentimisest ====
Kasutame basic-audentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Lahenduse võtsime kasutades [http://www.asp.net/web-api/overview/security/basic-authentication näidist veebis], kus on ära toodud ka antud lahenduse plussid ja miinused. Parooli räsi hoiame andmebaasis. Räsi genereerimiseks kasutasime [http://crackstation.net/hashing-security.htm veebis asuvat moodulit].

=== Veebiteenuse retsensioon meeskonna Leemur poolt ===

====1. töö vastavus esitatud tingimustele====

Töö täielikult esitatud tingimustele ei vasta, kuna kolmest alamülesandest on realiseeritud kaks esimest (teenuse pakkumine ning teenuse kasutajate tuvastamine ja haldamine). Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes ei ole töös realiseeritud. Ka kasutajate haldust ei ole väga põhjalikult realiseeritud. Samas see, mis on tehtud teenuse enda osas, on tehtud põhjalikult ja hästi.
Teenuse osa
Loodud on kontrollerid:

'''a. Home – kuvab esilehe'''

'''b. Upload – kuvab pildi üleslaadimise lehe'''

Pildi üleslaadimine aadressilt ~/Upload töötab. http://localhost:55878/Upload - autentisin anonymous kontoga. Muidugi võiks mainida, et lehel ei ole järjekindlust valitud keele rakendamiseks (üksik ’Lehitse’ nupp eesti keeles). Tulemuseks tagastatakse image objekt.

Pärast pildi üles laadimist, saab neid vaadata aadressilt http://localhost:55878/api/OriginalImage/{id}.

'''c. OriginalImage - annab tagasi originaalfaili, kui kasutaja on autoriseeritud'''

Realiseeritud on GET meetod, mis täiesti töötab http://localhost:55878/api/OriginalImage/{id}

'''d. ImageUpload''' – selle kontrolleri mõttest ei saa väga aru. Oleks eeldanud, et see suunab mind ~/Upload lehele. Aadressile ~/ImageUpload minnes sain vastuseks:

{
"$id": "1",
"Message": "The requested resource does not support http method 'GET'."
}

'''e. Thumb - leiab thumbnailsi pildile vastavalt ette antud tüübile small, medium, large ja pildi id'le'''

Realiseeritud on GET meetod, mis töötab ja tagastab pildi valitud suurusele:

http://localhost:55878/api/Thumb?id=1&type=small
http://localhost:55878/api/Thumb?id=1&type=medium
http://localhost:55878/api/Thumb?id=1&type=large

'''f. Image – tagastab image objekti, mis seotud kasutajaga'''

Realiseeritud on GET, PUT ja DELETE meetod. POST meetod suunab upload lehele. GetBy id meetodi miinuseks ütleks, et kui sisestada aadressi http://localhost:55878/api/image/{id} id selline väärtus, mida ei eksisteeri, siis ilmub tühi leht. Võiks olla mingi informatiivne tekst.

'''g. ImageComment - väljastab kõik kasutaja tehtud kommentaarid.'''

Realiseeritud on GET, POST, DELETE ja PUT meetod, mis tagastab MethodNotAllowed teate. Ning DELETE meetod on lubatud ainult administraatorile. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kommentaare muuta.

'''h. ImageCategory – väljastab piltide kategooria loendi,''' stiilis:

{
"$id": "1",
"Images": [],
"ImageCategoryID": 1,
"Name": "Uncategorized"
},
{
"$id": "2",
"Images": [],
"ImageCategoryID": 2,
"Name": "Loodus"
}

GET meetod on kõigile nähtav. Samuti realiseeritud POST, PUT ja DELETE vaid admin kasutajale. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kategooriaid muuta.

'''i. User – tagastab kasutajate loendi,''' stiilis

{
"$id": "1",
"UserID": "admin",
"Password": "1000:Lk6Jg3A+pcP4FRwfVO3VcUKESqyH19R7:I2j8NTisCxPn4/e0YL3zdr/9/xXfhGKk"
},
{
"$id": "2",
"UserID": "aleksandr",
"Password": "1000:FdJ5RNgQIvykcblEWaD576NbI6/ih/uf:ltScbkbx1bo1O0Ag94WjSEOikgJ2P0Sc"

}

Realiseeritud on '''GET ja POST''' meetodid. Iseasi, kas iga kasutaja peaks saama vaadata juba loodud kasutajate kontode andmeid. Ehk peaks ka siia panema administraatori õiguste kontrolli.

Kasutajate autentimise ja halduse osa

Kasutatud on basic autentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Parooli räsi hoitakse andmebaasis.

Kasutajate halduse poolelt on ainukestena realiseeritud User kontroller GET ja POST meetoditega. Ülesande püstituses soovitatut (luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE)) järgitud ei ole. Samas oli see ainult soovitus, mitte nõue.

====2. programmikoodi loetavus ning kommenteeritus====

Koodi ei ole ülemäära palju kommenteeritud, ent olemasolevad kommentaarid on piisavad, et toimuvast aru saada. Testimiseks ja retsenseerimiseks täiesti piisavad. Kood on loetav ja arusaadav.

====3. dokumentatsiooni olemasolu====

Eraldi dokumentatsiooni veebiteenusele lisatud ei ole. Samas ei ole see ka kusagil eraldi nõutud, seega otseselt miinuseks lugeda ei saa.

====4. kirjeldada puudusi====

Teenuse kasutajate ja kasutusstatistika üle arve pidamist ei toimu. Ka kasutajate halduse pool on ilmselt kiirustades realiseeritud. Põhjuseks tõenäoliselt
piiratud ajaressurss. Administraatori õigustega toimingute kontroll on kindlasti vaja ümber teha ja täiendada.

== Ülesanne 3 - Klient ==
Tähtaeg 10.06.2013
=== Windows phone 8 rakendus ===
==== Testimise juhend ====
Eeldused:
* Visual studio 2012
* Windows Phone 8 SDK

Seadistamine, et töötaks kõik kohalikust arvutist.
* Vaata oma arvuti IP-aadress (cmd ja ipconfig)
* Ava IIS-Express seadistusfail %USERPROFILE%\My Documents\IISExpress\config\applicationhost.config
* Määra saidi binding aadressiks localhost asemel oma arvuti IP-aadress. Juhul kui seda ei ole, käivita korra projekt.
<site name="PictureWebAPI" id="10">
<application path="/" applicationPool="Clr4IntegratedAppPool">
<virtualDirectory path="/" physicalPath="C:\DEV\PildiportaalWebAPI\PictureSolution\PictureWebAPI" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:55878:192.168.2.100" />
</bindings>
* Ava Projekti PictureWebAPI Seadistused (parem klõps ja properties)
* Määra "Project Url" väärtuseks: http://[IP-aadress]:55878/, näiteks "http://192.168.2.100:55878/"
* Määra WP8PicturePanorama projektis asuvas App.xaml.cs klassis parameetri APIBaseURL väärtuseks "http://[IP-aadress]:55878/"
* käivita käsurida admin õigustega, käsurealt: C:\Program Files\IIS Express>iisexpress.exe /site:"PictureWebAPI"
* Käivita WP8PicturePanorama projekt.

Terav C - Võrgurakendused 2 - projektileht

2013-06-10T06:24:26Z

Atsernik: /* Testimise juhend */

== Üldist ==
=== Liikmed ===
* Aleksandr Laidoner
* Oliver Dalberg
* Tarmo Sillajõe
* Andre Tšernikov

=== Teema valik - Pildiportaal ===
Valisime teemaks pildiportaali.

== Ülesanne 1 - XML ==
Tähtaeg 15.04.2013
=== XML - fail ===
Antud xml'i annab välja Pildiportaali veebiteenus selleks, et kliendid saaks kuvada galerii infot.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii.xml TeravC-galerii.xml]

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<galeriid>
<galerii id="1" kategooria="Loomad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="KB">200</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="3" vaade="suur">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">3</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="4" vaade="ikoon">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>png</formaat>
<suurus yhik="KB">230</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
<galerii id="2" kategooria="Linnad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>raw</formaat>
<suurus yhik="KB">220</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
</galeriid>

</source>

=== XSL - stiilifailid ===

==== Stiilifail 1 - inimsõbralik vaade xml faili sisust ====
Antud stiilifail vormindab inimsõbralikul tabeli kujul ülaloleva XML'i
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html1.xslt TeravC-galerii-xsl-html1.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>XML to HTML 1</title>
<style>
.theader { font-style:italic; text-decoration:underline; }
</style>

</head>
<body>
<H1>getPildid sõnumi sisu.</H1>
<xsl:for-each select="/galeriid/galerii">
<h3>
<xsl:text>Galerii nr. </xsl:text>
<xsl:value-of select="@id"/>
<xsl:text> (</xsl:text>
<xsl:value-of select="@kategooria"/>
<xsl:text>)</xsl:text>
</h3>
<table>
<tr class="theader">
<td>pilt.number</td>
<td>pilt.vaade</td>
<td>nimi</td>
<td>kirjeldus</td>
<td>formaat</td>
<td>suurus</td>
</tr>
<xsl:for-each select ="pildid/pilt">
<tr>
<td>
<xsl:value-of select="@number"/>
</td>
<td>
<xsl:value-of select="@vaade"/>
</td>
<td>
<xsl:value-of select="nimi"/>
</td>
<td>
<xsl:value-of select="kirjeldus"/>
</td>
<td>
<xsl:value-of select="formaat"/>
</td>
<td>
<xsl:value-of select="suurus"/>
<xsl:value-of select="suurus/@yhik"/>
</td>
</tr>
</xsl:for-each>
</table>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>

</source>

==== Stiilifail 2 - galerii vaade (ikoonid) ====
Antud stiilifail vormindab XML'i galeriilaadseks HTML'iks
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html2.xslt TeravC-galerii-xsl-html2.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>XML to HTML - Gallery</title>
<style>
div.img
{
margin: 2px;
border: 1px solid #0000ff;
height: auto;
width: auto;
float: left;
text-align: center;
}
div.img img
{
display: inline;
margin: 3px;
border: 1px solid #ffffff;
}
div.img a:hover img {border: 1px solid #0000ff;}
div.desc
{
text-align: center;
font-weight: normal;
width: 120px;
margin: 2px;
}
</style>

</head>
<body>
<xsl:for-each select="/galeriid/galerii">
<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<div class="img">
<a target="_blank" href="#">
<img
src="http://fc09.deviantart.net/fs6/i/2005/039/d/c/Not_Available_Icon_by_blacxthornE.jpg"
width="110"
height="90"/>

</a>
<div class="desc">
<xsl:value-of select="kirjeldus"/>
</div>
</div>
</xsl:if>
</xsl:for-each>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>
</source>

==== Stiilifail 3 - thumbnails xml ====
Antud stiilifail vormindab xml'i ringi selliselt, et kuvab masinsõbralikul kujul xml'i.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-xml.xslt TeravC-galerii-xsl-xml.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<thumbnails>

<xsl:for-each select="/galeriid/galerii">

<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<thumb>
<xsl:attribute name="number">
<xsl:value-of select="@number"/>
</xsl:attribute>
<nimi>
<xsl:value-of select="nimi"/>
</nimi>
<kirjeldus>
<xsl:value-of select="kirjeldus"/>
</kirjeldus>
<url>
<xsl:text>http://pildiportaal.mingidomeen.ee/getThumb.aspx?id=</xsl:text>
<xsl:value-of select="@number"/>
</url>
<lisatud>
<xsl:value-of select="lisatud/aasta"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/kuu"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/paev"/>
</lisatud>
</thumb>

</xsl:if>
</xsl:for-each>
</xsl:for-each>

</thumbnails>
</xsl:template>
</xsl:stylesheet>

</source>

=== Skeemifail ===
Antud skeemifail mõeldud ülalova ning sellelaadse xml faili valideerimiseks
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="yhikuTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="KB"/>
<xs:enumeration value="MB"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="vaateTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="ikoon"/>
<xs:enumeration value="suur"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="kategooriaTyyp">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][a-z]+"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="galeriid">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="galerii">
<xs:complexType>
<xs:sequence>
<xs:element name="pildid">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="200" name="pilt">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string" />
<xs:element name="kirjeldus" type="xs:string" />
<xs:element name="formaat" type="xs:string" />
<xs:element name="suurus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:unsignedInt">
<xs:attribute name="yhik" type="yhikuTyyp" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="lisatud">
<xs:complexType>
<xs:sequence>
<xs:element name="paev" type="xs:unsignedByte"/>
<xs:element name="kuu" type="xs:unsignedByte"/>
<xs:element name="aasta" type="xs:unsignedShort"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="number" type="xs:unsignedInt" use="required" />
<xs:attribute name="vaade" type="vaateTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="kategooria" type="kategooriaTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</source>

== Retsensioonid ==
XML

Kodutööna on loodud xml fail pildiportaali veebiteenuse välja andmiseks. Pildiportaal on mõeldud klientidele galerii info kuvamiseks. Xml failis on 6 loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat kui lihtsalt id. Lisaks on loodud ka xsd vormingus skeemifail xml faili valideerimiseks. Xml failile on loodud ka 3 xslt stiilifaili: esimene neist annab välja html vormingus tabeli – tabelis on toodud iga pildi number, vaade, nimi, kirjeldus, vormingu ning suuruse andmed. Lisaks on pildid tabelitesse jaotatud kategooriate järgi ning galeriid on ka nummerdatud; teise stiilifaili eesmärk on algse xml faili andmetest vormindada galeriilaadne html, mida see stiilifail ka teeb; kolmas stiilifail vormindab algse xml-i ringi selliselt, et kuvab masinsõbralikul kujul xml'i pildi nime, kirjelduse, url aadressi ning lisamise kuupäeva andmetega. Kodutöö vastab seega täielikult esitatud tingimustele.

Kood otseselt kommenteeritud ei ole, aga see-eest on iga faili üldotstarve välja toodud meeskonna wiki lehel iga konkreetse faili juures. Samuti on kood loetav ja arusaadav.

Dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga see ei olnud ka nõutud kodutöö ülesande püstituses. Seega ei saa seda lugeda tehtud töö puuduseks hindamise mõttes. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba praegu dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena tooks ehk välja, et pildi juures ei ole pildi lisaja või tegija andmeid. Tänases päevas on igasugused autoriõigused väga kuum teema.

Meeskond Leemur

== XML retsensioon ==

Esitatud xml’i peaks genereerima Pildiportaali veebiteenus. XML vastab igati kodutöö nõuetes kirjeldatud tingimustele: xml sisaldab kuus loogilist dimensiooni ja kasutatud on piisavalt atribuute. Sisu on igati loogiline, ehk oleks võinud ainult lisada veel ühe dimensiooni ja viia eraldi gruppidesse nö „ikoonid“ ja „suured“ pildid aga eks see on ka suuresti maitse asi.

Esimene xslt fail andis tulemuseks html kujul ilusa tabeli galeriides olevatest piltidest, näha on, et autorid olid sellega ka vaeva näinud ja kenasti tulemuse ära formaatinud. Teine xslt annab juba html kujul galeriivaate ikoonidest, mis on ka valmisolekuga lisada sinna link suuremale pildile (hetkel veel puudub aga pole ka selle ülesande skoobi mõttes oluline). Kolmas xslt moodustab algsest xml-st uue spetsiifilisema xml faili. Teeb seda päris kenasti, aga url-i leidmisel tekib väike viga. Nimelt ei ole seal arvestatud mitme galerii olemasoluga, kus id-sid alustatakse ühest alates. See on tekitanud selle, et url kahe erineva galerii piltidele sama id-ga on sisult identsed. Antud ülesande mõttes seda veaks ei loeks, kuna tehniliselt kõik toimib aga kui hilisemas faasis ka seda kasutada saab, siis peaks natuke xslt skripti täiendama.

Kokkuvõtteks võib öelda, et meeskond TeravC XML kodutöö vastab kõigile esitatud nõuetele ja on hästi teostatud. Kõik esitatud failid ka valideerusid.

Meeskond Hops

== Ülesanne 2 - Veebiteenus ==
Tähtaeg 20.05.2013

=== Web API lahendus 2013-05-20 ===
*Esmalt vabandame kõigi retsenseerijate ees - ei jõudnud väga testida.Kood on kättesaadav: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-20.zip PictureSolution_2013-05-20.zip]
*Õppejõule ligipääasetav TFS projekt: [https://oliverd.visualstudio.com https://oliverd.visualstudio.com]
* Lisandus 26.05.2013 silutud ja ilusamaks tehtud: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-26.zip PictureSolution_2013-05-26.zip]
==== Testiabi ====
===== Pildi loomine =====
* Uue pildi tekitamiseks tuleb laadida pilt ülesse. Selleks kasuta Upload Controllerit (~/Upload). Kasutaja ja parooli saab spikerdada PictureDAL -> Migrations -> Configurations.cs.
* ImageUpload api-controller annab tagasi Image tüüpi objekti, mida siis saab sisse süüa, vajaduse täiendada, ning PUT käsuga uuendada serveris (Kasutades nüüd juba Image api-controllerit)

===== Uue objekti loomine =====
Näiteks uue kommentaari lisamiseks kasuta alljärgnevat päringud fiddleris:
POST http://localhost:55878/api/imagecomment HTTP/1.1
Host: localhost:55878
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Authorization: Basic YWRtaW46c2VjcmV0

{
"ImageID": 1,
"Comment": "Comment 2, hinne 6",
"Rating": 6,
}

==== Audentimisest ====
Kasutame basic-audentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Lahenduse võtsime kasutades [http://www.asp.net/web-api/overview/security/basic-authentication näidist veebis], kus on ära toodud ka antud lahenduse plussid ja miinused. Parooli räsi hoiame andmebaasis. Räsi genereerimiseks kasutasime [http://crackstation.net/hashing-security.htm veebis asuvat moodulit].

=== Veebiteenuse retsensioon meeskonna Leemur poolt ===

====1. töö vastavus esitatud tingimustele====

Töö täielikult esitatud tingimustele ei vasta, kuna kolmest alamülesandest on realiseeritud kaks esimest (teenuse pakkumine ning teenuse kasutajate tuvastamine ja haldamine). Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes ei ole töös realiseeritud. Ka kasutajate haldust ei ole väga põhjalikult realiseeritud. Samas see, mis on tehtud teenuse enda osas, on tehtud põhjalikult ja hästi.
Teenuse osa
Loodud on kontrollerid:

'''a. Home – kuvab esilehe'''

'''b. Upload – kuvab pildi üleslaadimise lehe'''

Pildi üleslaadimine aadressilt ~/Upload töötab. http://localhost:55878/Upload - autentisin anonymous kontoga. Muidugi võiks mainida, et lehel ei ole järjekindlust valitud keele rakendamiseks (üksik ’Lehitse’ nupp eesti keeles). Tulemuseks tagastatakse image objekt.

Pärast pildi üles laadimist, saab neid vaadata aadressilt http://localhost:55878/api/OriginalImage/{id}.

'''c. OriginalImage - annab tagasi originaalfaili, kui kasutaja on autoriseeritud'''

Realiseeritud on GET meetod, mis täiesti töötab http://localhost:55878/api/OriginalImage/{id}

'''d. ImageUpload''' – selle kontrolleri mõttest ei saa väga aru. Oleks eeldanud, et see suunab mind ~/Upload lehele. Aadressile ~/ImageUpload minnes sain vastuseks:

{
"$id": "1",
"Message": "The requested resource does not support http method 'GET'."
}

'''e. Thumb - leiab thumbnailsi pildile vastavalt ette antud tüübile small, medium, large ja pildi id'le'''

Realiseeritud on GET meetod, mis töötab ja tagastab pildi valitud suurusele:

http://localhost:55878/api/Thumb?id=1&type=small
http://localhost:55878/api/Thumb?id=1&type=medium
http://localhost:55878/api/Thumb?id=1&type=large

'''f. Image – tagastab image objekti, mis seotud kasutajaga'''

Realiseeritud on GET, PUT ja DELETE meetod. POST meetod suunab upload lehele. GetBy id meetodi miinuseks ütleks, et kui sisestada aadressi http://localhost:55878/api/image/{id} id selline väärtus, mida ei eksisteeri, siis ilmub tühi leht. Võiks olla mingi informatiivne tekst.

'''g. ImageComment - väljastab kõik kasutaja tehtud kommentaarid.'''

Realiseeritud on GET, POST, DELETE ja PUT meetod, mis tagastab MethodNotAllowed teate. Ning DELETE meetod on lubatud ainult administraatorile. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kommentaare muuta.

'''h. ImageCategory – väljastab piltide kategooria loendi,''' stiilis:

{
"$id": "1",
"Images": [],
"ImageCategoryID": 1,
"Name": "Uncategorized"
},
{
"$id": "2",
"Images": [],
"ImageCategoryID": 2,
"Name": "Loodus"
}

GET meetod on kõigile nähtav. Samuti realiseeritud POST, PUT ja DELETE vaid admin kasutajale. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kategooriaid muuta.

'''i. User – tagastab kasutajate loendi,''' stiilis

{
"$id": "1",
"UserID": "admin",
"Password": "1000:Lk6Jg3A+pcP4FRwfVO3VcUKESqyH19R7:I2j8NTisCxPn4/e0YL3zdr/9/xXfhGKk"
},
{
"$id": "2",
"UserID": "aleksandr",
"Password": "1000:FdJ5RNgQIvykcblEWaD576NbI6/ih/uf:ltScbkbx1bo1O0Ag94WjSEOikgJ2P0Sc"

}

Realiseeritud on '''GET ja POST''' meetodid. Iseasi, kas iga kasutaja peaks saama vaadata juba loodud kasutajate kontode andmeid. Ehk peaks ka siia panema administraatori õiguste kontrolli.

Kasutajate autentimise ja halduse osa

Kasutatud on basic autentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Parooli räsi hoitakse andmebaasis.

Kasutajate halduse poolelt on ainukestena realiseeritud User kontroller GET ja POST meetoditega. Ülesande püstituses soovitatut (luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE)) järgitud ei ole. Samas oli see ainult soovitus, mitte nõue.

====2. programmikoodi loetavus ning kommenteeritus====

Koodi ei ole ülemäära palju kommenteeritud, ent olemasolevad kommentaarid on piisavad, et toimuvast aru saada. Testimiseks ja retsenseerimiseks täiesti piisavad. Kood on loetav ja arusaadav.

====3. dokumentatsiooni olemasolu====

Eraldi dokumentatsiooni veebiteenusele lisatud ei ole. Samas ei ole see ka kusagil eraldi nõutud, seega otseselt miinuseks lugeda ei saa.

====4. kirjeldada puudusi====

Teenuse kasutajate ja kasutusstatistika üle arve pidamist ei toimu. Ka kasutajate halduse pool on ilmselt kiirustades realiseeritud. Põhjuseks tõenäoliselt
piiratud ajaressurss. Administraatori õigustega toimingute kontroll on kindlasti vaja ümber teha ja täiendada.

== Ülesanne 3 - Klient ==
Tähtaeg 10.06.2013
=== Windows phone 8 rakendus ===
==== Testimise juhend ====
Eeldused:
* Visual studio 2012
* Windows Phone 8 SDK

Seadistamine, et töötaks kõik kohalikust arvutist.
* Vaata oma arvuti IP-aadress (cmd ja ipconfig)
* Ava IIS-Express seadistusfail %USERPROFILE%\My Documents\IISExpress\config\applicationhost.config
* Määra saidi binding aadressiks localhost asemel oma arvuti IP-aadress. Juhul kui seda ei ole, käivita korra projekt.
<site name="PictureWebAPI" id="10">
<application path="/" applicationPool="Clr4IntegratedAppPool">
<virtualDirectory path="/" physicalPath="C:\DEV\PildiportaalWebAPI\PictureSolution\PictureWebAPI" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:55878:192.168.2.100" />
</bindings>
* Ava Projekti PictureWebAPI Seadistused (parem klõps ja properties)
* Määra "Project Url" väärtuseks: http://[IP-aadress]:55878/, näiteks "http://192.168.2.100:55878/"
* Määra WP8PicturePanorama projektis asuvas MainViewModel.cs klassis API url-väärtuseks "http://[IP-aadress]:55878/"
* käivita käsurida admin õigustega, käsurealt: C:\Program Files\IIS Express>iisexpress.exe /site:"PictureWebAPI"
* Käivita WP8PicturePanorama projekt.

Terav C - Võrgurakendused 2 - projektileht

2013-06-10T06:15:00Z

Atsernik: /* Testimise juhend */

== Üldist ==
=== Liikmed ===
* Aleksandr Laidoner
* Oliver Dalberg
* Tarmo Sillajõe
* Andre Tšernikov

=== Teema valik - Pildiportaal ===
Valisime teemaks pildiportaali.

== Ülesanne 1 - XML ==
Tähtaeg 15.04.2013
=== XML - fail ===
Antud xml'i annab välja Pildiportaali veebiteenus selleks, et kliendid saaks kuvada galerii infot.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii.xml TeravC-galerii.xml]

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<galeriid>
<galerii id="1" kategooria="Loomad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Lind</nimi>
<kirjeldus>Ilus roheline lind</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="KB">200</suurus>
<lisatud>
<paev>01</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="3" vaade="suur">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">3</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="4" vaade="ikoon">
<nimi>Koer</nimi>
<kirjeldus>Minu koer</kirjeldus>
<formaat>png</formaat>
<suurus yhik="KB">230</suurus>
<lisatud>
<paev>02</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
<galerii id="2" kategooria="Linnad">
<pildid>
<pilt number="1" vaade="suur">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>jpg</formaat>
<suurus yhik="MB">2</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
<pilt number="2" vaade="ikoon">
<nimi>Tallinn</nimi>
<kirjeldus>Tallinn kevadel</kirjeldus>
<formaat>raw</formaat>
<suurus yhik="KB">220</suurus>
<lisatud>
<paev>08</paev>
<kuu>03</kuu>
<aasta>2012</aasta>
</lisatud>
</pilt>
</pildid>
</galerii>
</galeriid>

</source>

=== XSL - stiilifailid ===

==== Stiilifail 1 - inimsõbralik vaade xml faili sisust ====
Antud stiilifail vormindab inimsõbralikul tabeli kujul ülaloleva XML'i
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html1.xslt TeravC-galerii-xsl-html1.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>XML to HTML 1</title>
<style>
.theader { font-style:italic; text-decoration:underline; }
</style>

</head>
<body>
<H1>getPildid sõnumi sisu.</H1>
<xsl:for-each select="/galeriid/galerii">
<h3>
<xsl:text>Galerii nr. </xsl:text>
<xsl:value-of select="@id"/>
<xsl:text> (</xsl:text>
<xsl:value-of select="@kategooria"/>
<xsl:text>)</xsl:text>
</h3>
<table>
<tr class="theader">
<td>pilt.number</td>
<td>pilt.vaade</td>
<td>nimi</td>
<td>kirjeldus</td>
<td>formaat</td>
<td>suurus</td>
</tr>
<xsl:for-each select ="pildid/pilt">
<tr>
<td>
<xsl:value-of select="@number"/>
</td>
<td>
<xsl:value-of select="@vaade"/>
</td>
<td>
<xsl:value-of select="nimi"/>
</td>
<td>
<xsl:value-of select="kirjeldus"/>
</td>
<td>
<xsl:value-of select="formaat"/>
</td>
<td>
<xsl:value-of select="suurus"/>
<xsl:value-of select="suurus/@yhik"/>
</td>
</tr>
</xsl:for-each>
</table>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>

</source>

==== Stiilifail 2 - galerii vaade (ikoonid) ====
Antud stiilifail vormindab XML'i galeriilaadseks HTML'iks
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-html2.xslt TeravC-galerii-xsl-html2.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">

<html>
<head>
<title>XML to HTML - Gallery</title>
<style>
div.img
{
margin: 2px;
border: 1px solid #0000ff;
height: auto;
width: auto;
float: left;
text-align: center;
}
div.img img
{
display: inline;
margin: 3px;
border: 1px solid #ffffff;
}
div.img a:hover img {border: 1px solid #0000ff;}
div.desc
{
text-align: center;
font-weight: normal;
width: 120px;
margin: 2px;
}
</style>

</head>
<body>
<xsl:for-each select="/galeriid/galerii">
<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<div class="img">
<a target="_blank" href="#">
<img
src="http://fc09.deviantart.net/fs6/i/2005/039/d/c/Not_Available_Icon_by_blacxthornE.jpg"
width="110"
height="90"/>

</a>
<div class="desc">
<xsl:value-of select="kirjeldus"/>
</div>
</div>
</xsl:if>
</xsl:for-each>
</xsl:for-each>
</body>
</html>

</xsl:template>
</xsl:stylesheet>
</source>

==== Stiilifail 3 - thumbnails xml ====
Antud stiilifail vormindab xml'i ringi selliselt, et kuvab masinsõbralikul kujul xml'i.
* [http://paat-public.s3.amazonaws.com/ITCollege/VR2/TeravC-galerii-xsl-xml.xslt TeravC-galerii-xsl-xml.xslt]
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl"
>
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<thumbnails>

<xsl:for-each select="/galeriid/galerii">

<xsl:for-each select ="pildid/pilt">
<xsl:if test="@vaade='ikoon'">
<thumb>
<xsl:attribute name="number">
<xsl:value-of select="@number"/>
</xsl:attribute>
<nimi>
<xsl:value-of select="nimi"/>
</nimi>
<kirjeldus>
<xsl:value-of select="kirjeldus"/>
</kirjeldus>
<url>
<xsl:text>http://pildiportaal.mingidomeen.ee/getThumb.aspx?id=</xsl:text>
<xsl:value-of select="@number"/>
</url>
<lisatud>
<xsl:value-of select="lisatud/aasta"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/kuu"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="lisatud/paev"/>
</lisatud>
</thumb>

</xsl:if>
</xsl:for-each>
</xsl:for-each>

</thumbnails>
</xsl:template>
</xsl:stylesheet>

</source>

=== Skeemifail ===
Antud skeemifail mõeldud ülalova ning sellelaadse xml faili valideerimiseks
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="yhikuTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="KB"/>
<xs:enumeration value="MB"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="vaateTyyp">
<xs:restriction base="xs:string">
<xs:enumeration value="ikoon"/>
<xs:enumeration value="suur"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="kategooriaTyyp">
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][a-z]+"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="galeriid">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="galerii">
<xs:complexType>
<xs:sequence>
<xs:element name="pildid">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="200" name="pilt">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string" />
<xs:element name="kirjeldus" type="xs:string" />
<xs:element name="formaat" type="xs:string" />
<xs:element name="suurus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:unsignedInt">
<xs:attribute name="yhik" type="yhikuTyyp" use="required" />
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="lisatud">
<xs:complexType>
<xs:sequence>
<xs:element name="paev" type="xs:unsignedByte"/>
<xs:element name="kuu" type="xs:unsignedByte"/>
<xs:element name="aasta" type="xs:unsignedShort"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="number" type="xs:unsignedInt" use="required" />
<xs:attribute name="vaade" type="vaateTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:unsignedInt" use="required" />
<xs:attribute name="kategooria" type="kategooriaTyyp" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</source>

== Retsensioonid ==
XML

Kodutööna on loodud xml fail pildiportaali veebiteenuse välja andmiseks. Pildiportaal on mõeldud klientidele galerii info kuvamiseks. Xml failis on 6 loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat kui lihtsalt id. Lisaks on loodud ka xsd vormingus skeemifail xml faili valideerimiseks. Xml failile on loodud ka 3 xslt stiilifaili: esimene neist annab välja html vormingus tabeli – tabelis on toodud iga pildi number, vaade, nimi, kirjeldus, vormingu ning suuruse andmed. Lisaks on pildid tabelitesse jaotatud kategooriate järgi ning galeriid on ka nummerdatud; teise stiilifaili eesmärk on algse xml faili andmetest vormindada galeriilaadne html, mida see stiilifail ka teeb; kolmas stiilifail vormindab algse xml-i ringi selliselt, et kuvab masinsõbralikul kujul xml'i pildi nime, kirjelduse, url aadressi ning lisamise kuupäeva andmetega. Kodutöö vastab seega täielikult esitatud tingimustele.

Kood otseselt kommenteeritud ei ole, aga see-eest on iga faili üldotstarve välja toodud meeskonna wiki lehel iga konkreetse faili juures. Samuti on kood loetav ja arusaadav.

Dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga see ei olnud ka nõutud kodutöö ülesande püstituses. Seega ei saa seda lugeda tehtud töö puuduseks hindamise mõttes. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba praegu dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena tooks ehk välja, et pildi juures ei ole pildi lisaja või tegija andmeid. Tänases päevas on igasugused autoriõigused väga kuum teema.

Meeskond Leemur

== XML retsensioon ==

Esitatud xml’i peaks genereerima Pildiportaali veebiteenus. XML vastab igati kodutöö nõuetes kirjeldatud tingimustele: xml sisaldab kuus loogilist dimensiooni ja kasutatud on piisavalt atribuute. Sisu on igati loogiline, ehk oleks võinud ainult lisada veel ühe dimensiooni ja viia eraldi gruppidesse nö „ikoonid“ ja „suured“ pildid aga eks see on ka suuresti maitse asi.

Esimene xslt fail andis tulemuseks html kujul ilusa tabeli galeriides olevatest piltidest, näha on, et autorid olid sellega ka vaeva näinud ja kenasti tulemuse ära formaatinud. Teine xslt annab juba html kujul galeriivaate ikoonidest, mis on ka valmisolekuga lisada sinna link suuremale pildile (hetkel veel puudub aga pole ka selle ülesande skoobi mõttes oluline). Kolmas xslt moodustab algsest xml-st uue spetsiifilisema xml faili. Teeb seda päris kenasti, aga url-i leidmisel tekib väike viga. Nimelt ei ole seal arvestatud mitme galerii olemasoluga, kus id-sid alustatakse ühest alates. See on tekitanud selle, et url kahe erineva galerii piltidele sama id-ga on sisult identsed. Antud ülesande mõttes seda veaks ei loeks, kuna tehniliselt kõik toimib aga kui hilisemas faasis ka seda kasutada saab, siis peaks natuke xslt skripti täiendama.

Kokkuvõtteks võib öelda, et meeskond TeravC XML kodutöö vastab kõigile esitatud nõuetele ja on hästi teostatud. Kõik esitatud failid ka valideerusid.

Meeskond Hops

== Ülesanne 2 - Veebiteenus ==
Tähtaeg 20.05.2013

=== Web API lahendus 2013-05-20 ===
*Esmalt vabandame kõigi retsenseerijate ees - ei jõudnud väga testida.Kood on kättesaadav: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-20.zip PictureSolution_2013-05-20.zip]
*Õppejõule ligipääasetav TFS projekt: [https://oliverd.visualstudio.com https://oliverd.visualstudio.com]
* Lisandus 26.05.2013 silutud ja ilusamaks tehtud: [http://enos.itcollege.ee/~atsernik/vr2/PictureSolution_2013-05-26.zip PictureSolution_2013-05-26.zip]
==== Testiabi ====
===== Pildi loomine =====
* Uue pildi tekitamiseks tuleb laadida pilt ülesse. Selleks kasuta Upload Controllerit (~/Upload). Kasutaja ja parooli saab spikerdada PictureDAL -> Migrations -> Configurations.cs.
* ImageUpload api-controller annab tagasi Image tüüpi objekti, mida siis saab sisse süüa, vajaduse täiendada, ning PUT käsuga uuendada serveris (Kasutades nüüd juba Image api-controllerit)

===== Uue objekti loomine =====
Näiteks uue kommentaari lisamiseks kasuta alljärgnevat päringud fiddleris:
POST http://localhost:55878/api/imagecomment HTTP/1.1
Host: localhost:55878
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Authorization: Basic YWRtaW46c2VjcmV0

{
"ImageID": 1,
"Comment": "Comment 2, hinne 6",
"Rating": 6,
}

==== Audentimisest ====
Kasutame basic-audentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Lahenduse võtsime kasutades [http://www.asp.net/web-api/overview/security/basic-authentication näidist veebis], kus on ära toodud ka antud lahenduse plussid ja miinused. Parooli räsi hoiame andmebaasis. Räsi genereerimiseks kasutasime [http://crackstation.net/hashing-security.htm veebis asuvat moodulit].

=== Veebiteenuse retsensioon meeskonna Leemur poolt ===

====1. töö vastavus esitatud tingimustele====

Töö täielikult esitatud tingimustele ei vasta, kuna kolmest alamülesandest on realiseeritud kaks esimest (teenuse pakkumine ning teenuse kasutajate tuvastamine ja haldamine). Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes ei ole töös realiseeritud. Ka kasutajate haldust ei ole väga põhjalikult realiseeritud. Samas see, mis on tehtud teenuse enda osas, on tehtud põhjalikult ja hästi.
Teenuse osa
Loodud on kontrollerid:

'''a. Home – kuvab esilehe'''

'''b. Upload – kuvab pildi üleslaadimise lehe'''

Pildi üleslaadimine aadressilt ~/Upload töötab. http://localhost:55878/Upload - autentisin anonymous kontoga. Muidugi võiks mainida, et lehel ei ole järjekindlust valitud keele rakendamiseks (üksik ’Lehitse’ nupp eesti keeles). Tulemuseks tagastatakse image objekt.

Pärast pildi üles laadimist, saab neid vaadata aadressilt http://localhost:55878/api/OriginalImage/{id}.

'''c. OriginalImage - annab tagasi originaalfaili, kui kasutaja on autoriseeritud'''

Realiseeritud on GET meetod, mis täiesti töötab http://localhost:55878/api/OriginalImage/{id}

'''d. ImageUpload''' – selle kontrolleri mõttest ei saa väga aru. Oleks eeldanud, et see suunab mind ~/Upload lehele. Aadressile ~/ImageUpload minnes sain vastuseks:

{
"$id": "1",
"Message": "The requested resource does not support http method 'GET'."
}

'''e. Thumb - leiab thumbnailsi pildile vastavalt ette antud tüübile small, medium, large ja pildi id'le'''

Realiseeritud on GET meetod, mis töötab ja tagastab pildi valitud suurusele:

http://localhost:55878/api/Thumb?id=1&type=small
http://localhost:55878/api/Thumb?id=1&type=medium
http://localhost:55878/api/Thumb?id=1&type=large

'''f. Image – tagastab image objekti, mis seotud kasutajaga'''

Realiseeritud on GET, PUT ja DELETE meetod. POST meetod suunab upload lehele. GetBy id meetodi miinuseks ütleks, et kui sisestada aadressi http://localhost:55878/api/image/{id} id selline väärtus, mida ei eksisteeri, siis ilmub tühi leht. Võiks olla mingi informatiivne tekst.

'''g. ImageComment - väljastab kõik kasutaja tehtud kommentaarid.'''

Realiseeritud on GET, POST, DELETE ja PUT meetod, mis tagastab MethodNotAllowed teate. Ning DELETE meetod on lubatud ainult administraatorile. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kommentaare muuta.

'''h. ImageCategory – väljastab piltide kategooria loendi,''' stiilis:

{
"$id": "1",
"Images": [],
"ImageCategoryID": 1,
"Name": "Uncategorized"
},
{
"$id": "2",
"Images": [],
"ImageCategoryID": 2,
"Name": "Loodus"
}

GET meetod on kõigile nähtav. Samuti realiseeritud POST, PUT ja DELETE vaid admin kasutajale. Praegu on küll kontroll nii tehtud, et kasutaja nimi peab konkreetselt just „admin“ olema. Ehk tulevikus saavad näiteks kõik kasutajad, kes kuuluvad administrator õigustega kasutajate gruppi, kategooriaid muuta.

'''i. User – tagastab kasutajate loendi,''' stiilis

{
"$id": "1",
"UserID": "admin",
"Password": "1000:Lk6Jg3A+pcP4FRwfVO3VcUKESqyH19R7:I2j8NTisCxPn4/e0YL3zdr/9/xXfhGKk"
},
{
"$id": "2",
"UserID": "aleksandr",
"Password": "1000:FdJ5RNgQIvykcblEWaD576NbI6/ih/uf:ltScbkbx1bo1O0Ag94WjSEOikgJ2P0Sc"

}

Realiseeritud on '''GET ja POST''' meetodid. Iseasi, kas iga kasutaja peaks saama vaadata juba loodud kasutajate kontode andmeid. Ehk peaks ka siia panema administraatori õiguste kontrolli.

Kasutajate autentimise ja halduse osa

Kasutatud on basic autentimist, kuna lihtne realiseerida, samas üle SSL'i lahendus on täiesti akstepteeritava turva tasemega. Parooli räsi hoitakse andmebaasis.

Kasutajate halduse poolelt on ainukestena realiseeritud User kontroller GET ja POST meetoditega. Ülesande püstituses soovitatut (luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE)) järgitud ei ole. Samas oli see ainult soovitus, mitte nõue.

====2. programmikoodi loetavus ning kommenteeritus====

Koodi ei ole ülemäära palju kommenteeritud, ent olemasolevad kommentaarid on piisavad, et toimuvast aru saada. Testimiseks ja retsenseerimiseks täiesti piisavad. Kood on loetav ja arusaadav.

====3. dokumentatsiooni olemasolu====

Eraldi dokumentatsiooni veebiteenusele lisatud ei ole. Samas ei ole see ka kusagil eraldi nõutud, seega otseselt miinuseks lugeda ei saa.

====4. kirjeldada puudusi====

Teenuse kasutajate ja kasutusstatistika üle arve pidamist ei toimu. Ka kasutajate halduse pool on ilmselt kiirustades realiseeritud. Põhjuseks tõenäoliselt
piiratud ajaressurss. Administraatori õigustega toimingute kontroll on kindlasti vaja ümber teha ja täiendada.

== Ülesanne 3 - Klient ==
Tähtaeg 10.06.2013
=== Windows phone 8 rakendus ===
==== Testimise juhend ====
Eeldused:
* Visual studio 2012
* Windows Phone 8 SDK

Seadistamine, et töötaks kõik kohalikust arvutist.
* Vaata oma arvuti IP-aadress (cmd ja ipconfig)
* Ava IIS-Express seadistusfail %USERPROFILE%\My Documents\IISExpress\config\applicationhost.config
* Määra saidi binding aadressiks localhost asemel oma arvuti IP-aadress
<site name="PictureWebAPI" id="10">
<application path="/" applicationPool="Clr4IntegratedAppPool">
<virtualDirectory path="/" physicalPath="C:\DEV\PildiportaalWebAPI\PictureSolution\PictureWebAPI" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:55878:192.168.2.100" />
</bindings>
* Ava Projekti PictureWebAPI Seadistused (parem klõps ja properties)
*

Terav C - Võrgurakendused 2 - projektileht

2013-06-10T06:07:14Z

Atsernik: /* Ülesanne 3 - Klient */

Leemur

2013-05-27T17:13:46Z

Atsernik: /* DELETE */

==[[Leemur|Meeskond "Leemur"]] ==
*Liikmed
**Marika Mäemets
**Rasmus Hommuk
**Mairo Puusepp
**Einar Kivisalu

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==

Et käesoleval hetkel on aktuaalne teedelagunemine ja augud tekivad igalepoole üleöö, siis on meie XML asfaldiaukude teemaline.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<teeauk>
<tänavad>
<tänav id = "CU00609359" tyyp = "tänav">
<nimi>Raja</nimi>
<pikkus yhik="meeter">856</pikkus>
<augud>
<auk id = "1">
<xkoord>6584427.3</xkoord>
<ykoord>537660</ykoord>
<sügavus yhik="meeter">0.08</sügavus>
<pindala yhik="ruutmeeter">0.4</pindala>
<teataja id = "1">
<nimi>Peeter Linnakodanik</nimi>
<roll>autojuht</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-04-10</likvideeritud>
</auk>
<auk id = "2">
<xkoord>6584348.6</xkoord>
<ykoord>537658.6</ykoord>
<sügavus yhik="meeter">0.8</sügavus>
<pindala yhik="ruutmeeter">0.54</pindala>
<teataja id = "1">
<nimi>Peeter Linnakodanik</nimi>
<roll>autojuht</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
</auk>
</augud>
</tänav>
<tänav id = "CU00464822" tyyp = "tänav">
<nimi>Ehitajate tee</nimi>
<pikkus yhik="meeter">23</pikkus>
<augud>
<auk id = "3">
<xkoord>6584526.2</xkoord>
<ykoord>537923.8</ykoord>
<sügavus yhik="meeter">0.9</sügavus>
<pindala yhik="ruutmeeter">0.5</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
<auk id = "4">
<xkoord>6584655.9</xkoord>
<ykoord>537637.5</ykoord>
<sügavus yhik="meeter">0.6</sügavus>
<pindala yhik="ruutmeeter">0.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
<auk id = "5">
<xkoord>6584532</xkoord>
<ykoord>537954.2</ykoord>
<sügavus yhik="meeter">0.6</sügavus>
<pindala yhik="ruutmeeter">1.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00464824" tyyp = "tänav">
<nimi>Sõpruse puiestee</nimi>
<pikkus yhik="meeter">4623</pikkus>
<augud>
<auk id = "6">
<xkoord>6584621.1</xkoord>
<ykoord>538267</ykoord>
<sügavus yhik="meeter">0.11</sügavus>
<pindala yhik="ruutmeeter">2.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>

<tänav id = "CU00072238" tyyp = "tänav">
<nimi>Ranna tee</nimi>
<pikkus yhik="meeter">623</pikkus>
<augud>
<auk id = "11">
<xkoord>6587966.2</xkoord>
<ykoord>531049.2</ykoord>
<sügavus yhik="meeter">0.07</sügavus>
<pindala yhik="ruutmeeter">0.25</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00072411" tyyp = "tänav">
<nimi>Ranna tee</nimi>
<pikkus yhik="meeter">1023</pikkus>
<augud>
<auk id = "12">
<xkoord>6587827.8</xkoord>
<ykoord>531034.3</ykoord>
<sügavus yhik="meeter">0.07</sügavus>
<pindala yhik="ruutmeeter">0.75</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00069699" tyyp = "maantee">
<nimi>Klooga mnt</nimi>
<pikkus yhik="meeter">623</pikkus>
<augud>
<auk id = "13">
<xkoord>6588082</xkoord>
<ykoord>531159.8</ykoord>
<sügavus yhik="meeter">0.16</sügavus>
<pindala yhik="ruutmeeter">0.75</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>

<tänav id = "CU02094396" tyyp = "tänav">
<nimi>Nõlvaku tänav</nimi>
<pikkus yhik="meeter">823</pikkus>
<augud>
<auk id = "11">
<xkoord>6579325.4</xkoord>
<ykoord>536312.7</ykoord>
<sügavus yhik="meeter">0.11</sügavus>
<pindala yhik="ruutmeeter">1.55</pindala>
<teataja id = "4">
<nimi>Ülo Vallavanem</nimi>
<roll>Vallavanem</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
</tänavad>

</teeauk>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="XMLSchema1"
targetNamespace="http://tempuri.org/teeauk.xsd"
elementFormDefault="qualified"
xmlns="http://tempuri.org/teeauk.xsd"
xmlns:mstns="http://tempuri.org/teeauk.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
>
<xs:simpleType name="yhikpikkus">
<xs:restriction base="xs:string">
<xs:enumeration value="meeter"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="yhiksygavus">
<xs:restriction base="xs:string">
<xs:enumeration value="meeter"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="yhikpindala">
<xs:restriction base="xs:string">
<xs:enumeration value="ruutmeeter"/>
</xs:restriction>
</xs:simpleType>

<xs:element name="teeauk">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs ="0" maxOccurs="unbounded" name="tänavad">
<xs:complexType>
<xs:choice>
<xs:element minOccurs ="0" maxOccurs="unbounded" name="tänav">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string"></xs:element>
<xs:element name="pikkus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:int">
<xs:attribute name="yhik" type="yhikpikkus"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="augud">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="auk">
<xs:complexType>
<xs:sequence>
<xs:element name="xkoord" type="xs:double"></xs:element>
<xs:element name="ykoord" type="xs:double"></xs:element>
<xs:element name="sügavus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:double">
<xs:attribute name="yhik" type="yhiksygavus"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="pindala">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:double">
<xs:attribute name="yhik" type="yhikpindala"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="teataja">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string"></xs:element>
<xs:element name="roll" type="xs:string"></xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:int"></xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="avastatud" type="xs:date"></xs:element>
<xs:element name="likvideeritud" type="xs:date" minOccurs ="0"></xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:int"></xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:string"></xs:attribute>
<xs:attribute name="tyyp" type="xs:string"></xs:attribute>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

</source>

=== XSLT failid ===

==Asfaldiaukude tabel==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Asfaldiaugud üle kogu maa</title>
</head>
<body>
<h1>Asfaldiaukude nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav">
<li>
<xsl:value-of select="nimi"/>
<xsl:text> </xsl:text>
<xsl:value-of select="@tyyp"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="pikkus"/>
<xsl:value-of select="@yhik"/>
<xsl:text>-</xsl:text>
<table border="1">
<th>
<td>Koordinaadid</td>
<td>Sügavus ja pindlala</td>
<td>Teavitaja</td>
<td>Avastatud</td>
<td>Likvideeritud</td>
</th>
<xsl:for-each select="augud/auk">
<tr>
<td>
<xsl:value-of select="@id" />
</td>
<td>
<xsl:text>X </xsl:text>
<xsl:value-of select="xkoord" />
<br/>
<xsl:text>Y </xsl:text>
<xsl:value-of select="ykoord" />
</td>
<td>
<xsl:value-of select="sügavus" />
<br/>
<xsl:value-of select="pindala" />
</td>
<td>
<xsl:value-of select="teataja/nimi" />
<br/>
<xsl:value-of select="teataja/roll" />
</td>
<td>
<xsl:value-of select="avastatud" />
</td>
<td>
<xsl:value-of select="likvideeritud" />
<xsl:text>.</xsl:text>
</td>
</tr>
</xsl:for-each>
</table>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==Aukudest teatajad ==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Asfaldiaugud üle kogu maa</title>
</head>
<body>
<h1>Aukudest teatajate nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav/augud/auk/teataja">
<li>
<xsl:value-of select="./nimi"/>
<xsl:text> - </xsl:text>
<xsl:value-of select="./roll"/>
<xsl:text> </xsl:text>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

== Tänavate nimekiri ==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Teede/tänavate nimekiri</title>
</head>
<body>
<h1>Teede/tänavate nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav">
<li>
<xsl:value-of select="./nimi"/>
<xsl:text> - </xsl:text>
<xsl:value-of select="./pikkus"/>
<xsl:text> meetrit </xsl:text>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

== Retsensioonid ==

=== XML ===
====XML====
XML-failis on 6 loogilist dimensiooni. Tasemete kaupa välja kirjutatuna:
tase 1: teeauk
tase 2: tänavad
tase 3: tänav (atribuudid: tüüp)
tase 4: nimi, pikkus, augud
tase 5: auk
tase 6: xkoord, ykoord, sügavus, pindala, teataja, avastatud, likvideeritud.
Atribuute on kasutatud nõuetele vastavas koguses. Taseme "tänav" juurde on loodud atribuut "tyyp", mis võib olla kas "tänav" või "maantee". Rühma Leemur oleks võinud paari sõnaga kommenteerida, miks on tänava ja maantee eristamine oluline.

====XSD====
XSD-faili põhjal võib aukudega tänavaid ka üldse mitte eksisteerida või olla piiramata arv. Põhimõtteliselt võiks tänavate arv olla piiratud mõne mõistliku numbriga, aga samas ei tohiks ka piiramata arv olla probleem.
Dimensioon "tänavad" sisaldab järgmise tasemena elemente tüübist "tänav". Miks on sealjuures taseme "tänavad" elementide kirjeldamiseks kasutatud tag'i "choise", mille sees on ainult üks element?
Dimensiooni "tänavad" elemendid peavad olema kirjeldatud kindlas järjekorras (nimi, pikkus, augud). Koodi loetavuse seisukohalt on hea, kui see nii on.
Atribuutide kirjelduses võiks ehk augu pindala ja sügavus olla lubatud kirjeldada ka vastavalt sentimeetrites ja ruutsentimeetrites.

====XSL====
XSL-faile on kokku 3, mida on rohkem kui minimaalselt nõutud- 2.
Asfaldiaukude tabel
Tabelis on augu id, koordinaadid, pindala, teataja nimi ja roll, avastamise ja likvideerimise kuupäev.
Aukudest teatajate tabel
Tabelis näidatakse teatajate nimesid ja rollisid.
Tänavate tabel
Näidatakse tänavanimesid koos tänavate pikkustega.
Mõne sõnaga võiks ehk kirjeldada, millist eesmärki html-kujule teisendatud tabelid kasutaja seisukohast võiksid täita.

Kokkuvõtvalt võib öelda, et meeskond "Leemur" on oma XML-, XSD -ja XSL-failid koostanud loogiliselt ja hästi struktureeritult.

Meeskond TeravC

--------------------

Tiim "Leemur" on pakkunud välja XML liidese definitsiooni tänavaaukude kohta käiva info edastamiseks. Teema on igati ajakohane ning antud lahendus omab ka reaalset rakendust näiteks autojuhi GPS tarkvaras. Iseasi, et andmemahu kokkuhoiu mõttes võibolla oleks kasulik terved kohad edastada aukude asemel.

Esitatud lahendus vastab kodutöös nõutud tingimustele ja ootustele keerukuse osas ning isegi ületab neid. XML faili struktuur on arusaadav ja lisakommentaare ei vaja.
Näidisena välja pakutud XSLT abil õnnestub genereerida väljund nii HTML kui XML formaadis.

Andmete grupeerimine tänavate kaupa tundub mõistlik arvestades potentsiaalse info tarbija vajadust saada infot parasjagu läbitava tänava kohta. Tänava pikkuse esitamise vajadusest ei saa hästi aru. Aukudel on ka omadus taastekkida, antud struktuur võimaldab aga esitada ühe(viimase?) teataja ning parandaja. Rakenduse võib muidugi luua selliselt, et uuesti teatades muutub parandaja väli väljund XML'is uuesti tühjaks. samas oleks hea info aukude kohta, mis pidevalt lagunevad ja parandatud saavad.

XML välja nimetuses täpitähtede kasutamine ei pruugi olla alati hea mõte, ehkki on loomulikult lubatud.

Meeskond Hops

== Veebiteenus ==

Jätkame asfaldiaukude teemaga, kuna tänavate seisukord on endiselt päevakorral olev teema ja ei ole näha, et see aktuaalsuse minetaks.

Veebiteenus peab olema valmis ja ja wikilehel kirjeldatud hiljemalt 20. mai 2013.

Retsensioonid veebiteenuste kohta peavad tehtud olema 27. mai 2013

*'''Loodav veebiteenus peab võimaldama:'''
** Teenuse pakkumist
** Teenuse kasutajate tuvastamist ning haldamist
** Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

=== plaanitav funktsionaalsus ===
- teha teenus, mis väljastab viimased lisatud augud
- teha teenus, mis väljastab valitud tänaval asuvad augud
- teha teenus, mis väljastab kõige suurema aukude arvuga tänavad (suhtes pikkusega)
- teha teenus, mis ...
- teha teenus, mis ...

=== Tööde edenemine ===
- Versioonihaldus ülesse seada - Asjassepühendatute jaoks paikneb see siin: https://leemur.visualstudio.com/ ''15.05.2013.''
- Andmebaasiserver töökorda seada (OK - Rasmus). Installeeritud MS SQL Express 12 (version 11.0.3128.0) ''16.05.2013''
- Domeeni mudel valmis teha - OK
- EF raamistik paika () - OK
- Luua standard Repod iga objekti klassi kohta (I{KlassiNimi}Repository + {KlassiNimi}Repository)
Olemas AukRepository, EFRepositories, KasutusRepository, RollRepository, TanavRepository, TeavitajaRepository

- Funktsionaalsuse teostus (Controllers) (Get + Post + Put + Delete) - OK

- Autentimine, Autoriseerimine - veidi problemaatiline.

Veebiteenuse koodi võib leida siit: http://enos.itcollege.ee/~rhommuk/Poska/Asfaldiauk.zip ''20.05.2013.''<br/>
Realiseeritud meetodite testimiseks on kasutatav aadress ~/Help

=== Veebiteenuse retsensioon - TeravC ===

==== Enne retsenseerima asumist meeskonna Leemur poolt esitatud teadaolevad puudused ====
"Retsenseerides võib kohe kirja panna, et autentimist ega kasutajate statistikat ei ole ... meil on ainult teenus lahendatud."

==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
*Andmemudeli teek (AsfaldiaukModels),
*Andme ligipääsu teek (AsfaldiaukDAL),
*Teenuse enda teostus (AsfaldiaukWebAPI).
Testide tegemiseks loodud ka konsoolirakendus AsfaldiaukTest. Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt.
Projekti luues oleks võnud "Create unit test projecti" lahtrisse linnukese teha kuid kuna antud raames me unit teste ei kirjuta siis liiga oluline see ei ole.

==== Domeeni mudel ====
Natuke on ka arusaamatu, milleks on väljaminevad seosed defineeritud eraldi klassides. Annotatsioonid on täiesti olemas kuid võiks võib-olla kohati natuke rohkem lubatud olla,
näiteks AukMall.cs public string Kommentaar lubab 50 tähemärki, mille sisse tekst "Selline pirakas teeauk, et lõhkusin autol parempoolse esiratta ja midagi veel." juba enam ära ei mahu.

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Võetud kasutusele valmiskirjutatud IEFRepository.cs + EFRepositor.cs
Dependency resolver osas kasutusel Ninject ja loodud ka vajalik dummy IAsfaldiaukContext.cs interface selle toimimiseks.
Migrations->configuration.cs all võiks internal sealed class... muuta publicuks.

==== Web API teenus ====
Peale konsoolirakenduse käivitamist ning andmete baasi saamist võis asuda ka teenust testmima. Nii konsoolirakenduse kui webAPI connectionstring oli määratud (localdb)\v11.0, mille
tõttu oli loodud baas kohe hõlpsasti leitav. Baasi loomise/muutmise osas on arendusfaasis kasutatud strateegiat DropCreateDatabaseAlways.

Web API teenus töötab, näitena: api/auk väljastab aukude nimekirja. Teenus annab andmeid JSON formaadis.
Controllerid koos vajalike CRUD meetoditega olid kohandatud vastavalt vajadustele ja loodud igale klassile.

==== Testimine ====
Kasutasin TanavController.cs klassi kuna seal olid kõik CRUD meetodid kirjeldatud:
===== GET api/tanav =====

HTTP päringu sisu:
GET http://localhost:49407/api/tanav HTTP/1.1
User-Agent: Fiddler
Host: localhost:49407

HTTP vastus päringule:
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcb2RhbGJlcmdcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlcdGFuYXY=?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 00:20:36 GMT
Content-Length: 78

[
{
"TanavID": 1,
"Nimi": "Mustamae",
"Pikkus": 3.87
}
]

===== GET api/tanav/1 =====
Sama vastus nagu eelmine.

===== GET api/tanav/2 =====
HTTP päringu sisu:
GET http://localhost:49407/api/tanav/2 HTTP/1.1
User-Agent: Fiddler
Host: localhost:49407

HTTP päringu vastus:
HTTP/1.1 404 Not Found
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcb2RhbGJlcmdcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlcdGFuYXZcMg==?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 00:23:21 GMT
Content-Length: 44

"Sellise id-ga tänavat andmebaasis ei ole!"

===== POST =====
HTTP POST päringu sisu:
POST http://localhost:49407/api/roll HTTP/1.1
Host: localhost:49407
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Content-Length: 57

{
"RollID": 1,
"Nimi": "sample string 2"
}

HTTP POST päringu vastus:
HTTP/1.1 201 Created
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Location: http://localhost:49407/Help?id=1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlccm9sbA==?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 17:05:28 GMT
Content-Length: 0

===== PUT =====
HTTP Päringu sisu:
PUT http://localhost:49407/api/roll/1 HTTP/1.1
Host: localhost:49407
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Content-Length: 55

{
"RollID": 1,
"Nimi": "new Role name"
}

HTTP Päringu vastus:
HTTP/1.1 204 No Content
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlccm9sbFwx?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 17:08:50 GMT

===== DELETE =====
HTTP Päringu sisu:
DELETE http://localhost:49407/api/roll/1 HTTP/1.1
Host: localhost:49407
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json

HTTP Päringu vastus:
HTTP/1.1 204 No Content
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlccm9sbFwx?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 17:12:29 GMT

Peale Fiddleriga läbi proovimist said retsenseerijad teada, et meeskond Leemur on realiseerinud /help controlleri, mille kaudu on võimalik ilma Fiddleri
abita kõikides controllerites realiseeritud CRUD meetodeid hõlpsasti testida. Teatavasti topelt ei kärise ja sai ka /help uuritud, kus kõik toimis kenasti.

==== Kodeerimise stiil ja parimad praktikad ====

Stiil oli okei, kommentaare võiks alati rohkem olla. Ära ei olnud märgitud viited kui oli kasutatud weebi ja õppejõudude materjali abi. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab. Controllerite osas võiks tuleviku tarbeks luua ja eraldada api controllerid ning tavalised/view eraldi kaustadesse lihtsama jälgitavuse tarbeks.
Käveri ASP.NET kodutöö kaitsmistest meelde jäänud soovitus, mida ta jõudis korrata mitmeid kordi: "Ärge kirjutage võimaluse korral koodi eesti keeles, kuna reaalses elus toimub kogu töö ainult inglise keeles."

== Klientrakendus ==

Klientrakendused peavad olema valmis ja wikilehel kirjeldatud hiljemalt 10. juuni 2013.
Retsensioonid veebiteenuste kohta peavad tehtud olema 15. juuni 2013

Klientrakendus mõnele olemasolevale veebiteenusele, võib olla teostatud veebirakendusena, Silverlight, WPF või vormirakendusena.

Variant1: teha klientrakendus enda loodud veebiteenusele

Leemur

2013-05-27T17:10:08Z

Atsernik: /* PUT */

==[[Leemur|Meeskond "Leemur"]] ==
*Liikmed
**Marika Mäemets
**Rasmus Hommuk
**Mairo Puusepp
**Einar Kivisalu

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==

Et käesoleval hetkel on aktuaalne teedelagunemine ja augud tekivad igalepoole üleöö, siis on meie XML asfaldiaukude teemaline.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<teeauk>
<tänavad>
<tänav id = "CU00609359" tyyp = "tänav">
<nimi>Raja</nimi>
<pikkus yhik="meeter">856</pikkus>
<augud>
<auk id = "1">
<xkoord>6584427.3</xkoord>
<ykoord>537660</ykoord>
<sügavus yhik="meeter">0.08</sügavus>
<pindala yhik="ruutmeeter">0.4</pindala>
<teataja id = "1">
<nimi>Peeter Linnakodanik</nimi>
<roll>autojuht</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-04-10</likvideeritud>
</auk>
<auk id = "2">
<xkoord>6584348.6</xkoord>
<ykoord>537658.6</ykoord>
<sügavus yhik="meeter">0.8</sügavus>
<pindala yhik="ruutmeeter">0.54</pindala>
<teataja id = "1">
<nimi>Peeter Linnakodanik</nimi>
<roll>autojuht</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
</auk>
</augud>
</tänav>
<tänav id = "CU00464822" tyyp = "tänav">
<nimi>Ehitajate tee</nimi>
<pikkus yhik="meeter">23</pikkus>
<augud>
<auk id = "3">
<xkoord>6584526.2</xkoord>
<ykoord>537923.8</ykoord>
<sügavus yhik="meeter">0.9</sügavus>
<pindala yhik="ruutmeeter">0.5</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
<auk id = "4">
<xkoord>6584655.9</xkoord>
<ykoord>537637.5</ykoord>
<sügavus yhik="meeter">0.6</sügavus>
<pindala yhik="ruutmeeter">0.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
<auk id = "5">
<xkoord>6584532</xkoord>
<ykoord>537954.2</ykoord>
<sügavus yhik="meeter">0.6</sügavus>
<pindala yhik="ruutmeeter">1.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00464824" tyyp = "tänav">
<nimi>Sõpruse puiestee</nimi>
<pikkus yhik="meeter">4623</pikkus>
<augud>
<auk id = "6">
<xkoord>6584621.1</xkoord>
<ykoord>538267</ykoord>
<sügavus yhik="meeter">0.11</sügavus>
<pindala yhik="ruutmeeter">2.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>

<tänav id = "CU00072238" tyyp = "tänav">
<nimi>Ranna tee</nimi>
<pikkus yhik="meeter">623</pikkus>
<augud>
<auk id = "11">
<xkoord>6587966.2</xkoord>
<ykoord>531049.2</ykoord>
<sügavus yhik="meeter">0.07</sügavus>
<pindala yhik="ruutmeeter">0.25</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00072411" tyyp = "tänav">
<nimi>Ranna tee</nimi>
<pikkus yhik="meeter">1023</pikkus>
<augud>
<auk id = "12">
<xkoord>6587827.8</xkoord>
<ykoord>531034.3</ykoord>
<sügavus yhik="meeter">0.07</sügavus>
<pindala yhik="ruutmeeter">0.75</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00069699" tyyp = "maantee">
<nimi>Klooga mnt</nimi>
<pikkus yhik="meeter">623</pikkus>
<augud>
<auk id = "13">
<xkoord>6588082</xkoord>
<ykoord>531159.8</ykoord>
<sügavus yhik="meeter">0.16</sügavus>
<pindala yhik="ruutmeeter">0.75</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>

<tänav id = "CU02094396" tyyp = "tänav">
<nimi>Nõlvaku tänav</nimi>
<pikkus yhik="meeter">823</pikkus>
<augud>
<auk id = "11">
<xkoord>6579325.4</xkoord>
<ykoord>536312.7</ykoord>
<sügavus yhik="meeter">0.11</sügavus>
<pindala yhik="ruutmeeter">1.55</pindala>
<teataja id = "4">
<nimi>Ülo Vallavanem</nimi>
<roll>Vallavanem</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
</tänavad>

</teeauk>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="XMLSchema1"
targetNamespace="http://tempuri.org/teeauk.xsd"
elementFormDefault="qualified"
xmlns="http://tempuri.org/teeauk.xsd"
xmlns:mstns="http://tempuri.org/teeauk.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
>
<xs:simpleType name="yhikpikkus">
<xs:restriction base="xs:string">
<xs:enumeration value="meeter"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="yhiksygavus">
<xs:restriction base="xs:string">
<xs:enumeration value="meeter"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="yhikpindala">
<xs:restriction base="xs:string">
<xs:enumeration value="ruutmeeter"/>
</xs:restriction>
</xs:simpleType>

<xs:element name="teeauk">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs ="0" maxOccurs="unbounded" name="tänavad">
<xs:complexType>
<xs:choice>
<xs:element minOccurs ="0" maxOccurs="unbounded" name="tänav">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string"></xs:element>
<xs:element name="pikkus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:int">
<xs:attribute name="yhik" type="yhikpikkus"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="augud">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="auk">
<xs:complexType>
<xs:sequence>
<xs:element name="xkoord" type="xs:double"></xs:element>
<xs:element name="ykoord" type="xs:double"></xs:element>
<xs:element name="sügavus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:double">
<xs:attribute name="yhik" type="yhiksygavus"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="pindala">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:double">
<xs:attribute name="yhik" type="yhikpindala"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="teataja">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string"></xs:element>
<xs:element name="roll" type="xs:string"></xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:int"></xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="avastatud" type="xs:date"></xs:element>
<xs:element name="likvideeritud" type="xs:date" minOccurs ="0"></xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:int"></xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:string"></xs:attribute>
<xs:attribute name="tyyp" type="xs:string"></xs:attribute>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

</source>

=== XSLT failid ===

==Asfaldiaukude tabel==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Asfaldiaugud üle kogu maa</title>
</head>
<body>
<h1>Asfaldiaukude nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav">
<li>
<xsl:value-of select="nimi"/>
<xsl:text> </xsl:text>
<xsl:value-of select="@tyyp"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="pikkus"/>
<xsl:value-of select="@yhik"/>
<xsl:text>-</xsl:text>
<table border="1">
<th>
<td>Koordinaadid</td>
<td>Sügavus ja pindlala</td>
<td>Teavitaja</td>
<td>Avastatud</td>
<td>Likvideeritud</td>
</th>
<xsl:for-each select="augud/auk">
<tr>
<td>
<xsl:value-of select="@id" />
</td>
<td>
<xsl:text>X </xsl:text>
<xsl:value-of select="xkoord" />
<br/>
<xsl:text>Y </xsl:text>
<xsl:value-of select="ykoord" />
</td>
<td>
<xsl:value-of select="sügavus" />
<br/>
<xsl:value-of select="pindala" />
</td>
<td>
<xsl:value-of select="teataja/nimi" />
<br/>
<xsl:value-of select="teataja/roll" />
</td>
<td>
<xsl:value-of select="avastatud" />
</td>
<td>
<xsl:value-of select="likvideeritud" />
<xsl:text>.</xsl:text>
</td>
</tr>
</xsl:for-each>
</table>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==Aukudest teatajad ==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Asfaldiaugud üle kogu maa</title>
</head>
<body>
<h1>Aukudest teatajate nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav/augud/auk/teataja">
<li>
<xsl:value-of select="./nimi"/>
<xsl:text> - </xsl:text>
<xsl:value-of select="./roll"/>
<xsl:text> </xsl:text>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

== Tänavate nimekiri ==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Teede/tänavate nimekiri</title>
</head>
<body>
<h1>Teede/tänavate nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav">
<li>
<xsl:value-of select="./nimi"/>
<xsl:text> - </xsl:text>
<xsl:value-of select="./pikkus"/>
<xsl:text> meetrit </xsl:text>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

== Retsensioonid ==

=== XML ===
====XML====
XML-failis on 6 loogilist dimensiooni. Tasemete kaupa välja kirjutatuna:
tase 1: teeauk
tase 2: tänavad
tase 3: tänav (atribuudid: tüüp)
tase 4: nimi, pikkus, augud
tase 5: auk
tase 6: xkoord, ykoord, sügavus, pindala, teataja, avastatud, likvideeritud.
Atribuute on kasutatud nõuetele vastavas koguses. Taseme "tänav" juurde on loodud atribuut "tyyp", mis võib olla kas "tänav" või "maantee". Rühma Leemur oleks võinud paari sõnaga kommenteerida, miks on tänava ja maantee eristamine oluline.

====XSD====
XSD-faili põhjal võib aukudega tänavaid ka üldse mitte eksisteerida või olla piiramata arv. Põhimõtteliselt võiks tänavate arv olla piiratud mõne mõistliku numbriga, aga samas ei tohiks ka piiramata arv olla probleem.
Dimensioon "tänavad" sisaldab järgmise tasemena elemente tüübist "tänav". Miks on sealjuures taseme "tänavad" elementide kirjeldamiseks kasutatud tag'i "choise", mille sees on ainult üks element?
Dimensiooni "tänavad" elemendid peavad olema kirjeldatud kindlas järjekorras (nimi, pikkus, augud). Koodi loetavuse seisukohalt on hea, kui see nii on.
Atribuutide kirjelduses võiks ehk augu pindala ja sügavus olla lubatud kirjeldada ka vastavalt sentimeetrites ja ruutsentimeetrites.

====XSL====
XSL-faile on kokku 3, mida on rohkem kui minimaalselt nõutud- 2.
Asfaldiaukude tabel
Tabelis on augu id, koordinaadid, pindala, teataja nimi ja roll, avastamise ja likvideerimise kuupäev.
Aukudest teatajate tabel
Tabelis näidatakse teatajate nimesid ja rollisid.
Tänavate tabel
Näidatakse tänavanimesid koos tänavate pikkustega.
Mõne sõnaga võiks ehk kirjeldada, millist eesmärki html-kujule teisendatud tabelid kasutaja seisukohast võiksid täita.

Kokkuvõtvalt võib öelda, et meeskond "Leemur" on oma XML-, XSD -ja XSL-failid koostanud loogiliselt ja hästi struktureeritult.

Meeskond TeravC

--------------------

Tiim "Leemur" on pakkunud välja XML liidese definitsiooni tänavaaukude kohta käiva info edastamiseks. Teema on igati ajakohane ning antud lahendus omab ka reaalset rakendust näiteks autojuhi GPS tarkvaras. Iseasi, et andmemahu kokkuhoiu mõttes võibolla oleks kasulik terved kohad edastada aukude asemel.

Esitatud lahendus vastab kodutöös nõutud tingimustele ja ootustele keerukuse osas ning isegi ületab neid. XML faili struktuur on arusaadav ja lisakommentaare ei vaja.
Näidisena välja pakutud XSLT abil õnnestub genereerida väljund nii HTML kui XML formaadis.

Andmete grupeerimine tänavate kaupa tundub mõistlik arvestades potentsiaalse info tarbija vajadust saada infot parasjagu läbitava tänava kohta. Tänava pikkuse esitamise vajadusest ei saa hästi aru. Aukudel on ka omadus taastekkida, antud struktuur võimaldab aga esitada ühe(viimase?) teataja ning parandaja. Rakenduse võib muidugi luua selliselt, et uuesti teatades muutub parandaja väli väljund XML'is uuesti tühjaks. samas oleks hea info aukude kohta, mis pidevalt lagunevad ja parandatud saavad.

XML välja nimetuses täpitähtede kasutamine ei pruugi olla alati hea mõte, ehkki on loomulikult lubatud.

Meeskond Hops

== Veebiteenus ==

Jätkame asfaldiaukude teemaga, kuna tänavate seisukord on endiselt päevakorral olev teema ja ei ole näha, et see aktuaalsuse minetaks.

Veebiteenus peab olema valmis ja ja wikilehel kirjeldatud hiljemalt 20. mai 2013.

Retsensioonid veebiteenuste kohta peavad tehtud olema 27. mai 2013

*'''Loodav veebiteenus peab võimaldama:'''
** Teenuse pakkumist
** Teenuse kasutajate tuvastamist ning haldamist
** Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

=== plaanitav funktsionaalsus ===
- teha teenus, mis väljastab viimased lisatud augud
- teha teenus, mis väljastab valitud tänaval asuvad augud
- teha teenus, mis väljastab kõige suurema aukude arvuga tänavad (suhtes pikkusega)
- teha teenus, mis ...
- teha teenus, mis ...

=== Tööde edenemine ===
- Versioonihaldus ülesse seada - Asjassepühendatute jaoks paikneb see siin: https://leemur.visualstudio.com/ ''15.05.2013.''
- Andmebaasiserver töökorda seada (OK - Rasmus). Installeeritud MS SQL Express 12 (version 11.0.3128.0) ''16.05.2013''
- Domeeni mudel valmis teha - OK
- EF raamistik paika () - OK
- Luua standard Repod iga objekti klassi kohta (I{KlassiNimi}Repository + {KlassiNimi}Repository)
Olemas AukRepository, EFRepositories, KasutusRepository, RollRepository, TanavRepository, TeavitajaRepository

- Funktsionaalsuse teostus (Controllers) (Get + Post + Put + Delete) - OK

- Autentimine, Autoriseerimine - veidi problemaatiline.

Veebiteenuse koodi võib leida siit: http://enos.itcollege.ee/~rhommuk/Poska/Asfaldiauk.zip ''20.05.2013.''<br/>
Realiseeritud meetodite testimiseks on kasutatav aadress ~/Help

=== Veebiteenuse retsensioon - TeravC ===

==== Enne retsenseerima asumist meeskonna Leemur poolt esitatud teadaolevad puudused ====
"Retsenseerides võib kohe kirja panna, et autentimist ega kasutajate statistikat ei ole ... meil on ainult teenus lahendatud."

==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
*Andmemudeli teek (AsfaldiaukModels),
*Andme ligipääsu teek (AsfaldiaukDAL),
*Teenuse enda teostus (AsfaldiaukWebAPI).
Testide tegemiseks loodud ka konsoolirakendus AsfaldiaukTest. Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt.
Projekti luues oleks võnud "Create unit test projecti" lahtrisse linnukese teha kuid kuna antud raames me unit teste ei kirjuta siis liiga oluline see ei ole.

==== Domeeni mudel ====
Natuke on ka arusaamatu, milleks on väljaminevad seosed defineeritud eraldi klassides. Annotatsioonid on täiesti olemas kuid võiks võib-olla kohati natuke rohkem lubatud olla,
näiteks AukMall.cs public string Kommentaar lubab 50 tähemärki, mille sisse tekst "Selline pirakas teeauk, et lõhkusin autol parempoolse esiratta ja midagi veel." juba enam ära ei mahu.

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Võetud kasutusele valmiskirjutatud IEFRepository.cs + EFRepositor.cs
Dependency resolver osas kasutusel Ninject ja loodud ka vajalik dummy IAsfaldiaukContext.cs interface selle toimimiseks.
Migrations->configuration.cs all võiks internal sealed class... muuta publicuks.

==== Web API teenus ====
Peale konsoolirakenduse käivitamist ning andmete baasi saamist võis asuda ka teenust testmima. Nii konsoolirakenduse kui webAPI connectionstring oli määratud (localdb)\v11.0, mille
tõttu oli loodud baas kohe hõlpsasti leitav. Baasi loomise/muutmise osas on arendusfaasis kasutatud strateegiat DropCreateDatabaseAlways.

Web API teenus töötab, näitena: api/auk väljastab aukude nimekirja. Teenus annab andmeid JSON formaadis.
Controllerid koos vajalike CRUD meetoditega olid kohandatud vastavalt vajadustele ja loodud igale klassile.

==== Testimine ====
Kasutasin TanavController.cs klassi kuna seal olid kõik CRUD meetodid kirjeldatud:
===== GET api/tanav =====

HTTP päringu sisu:
GET http://localhost:49407/api/tanav HTTP/1.1
User-Agent: Fiddler
Host: localhost:49407

HTTP vastus päringule:
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcb2RhbGJlcmdcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlcdGFuYXY=?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 00:20:36 GMT
Content-Length: 78

[
{
"TanavID": 1,
"Nimi": "Mustamae",
"Pikkus": 3.87
}
]

===== GET api/tanav/1 =====
Sama vastus nagu eelmine.

===== GET api/tanav/2 =====
HTTP päringu sisu:
GET http://localhost:49407/api/tanav/2 HTTP/1.1
User-Agent: Fiddler
Host: localhost:49407

HTTP päringu vastus:
HTTP/1.1 404 Not Found
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcb2RhbGJlcmdcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlcdGFuYXZcMg==?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 00:23:21 GMT
Content-Length: 44

"Sellise id-ga tänavat andmebaasis ei ole!"

===== POST =====
HTTP POST päringu sisu:
POST http://localhost:49407/api/roll HTTP/1.1
Host: localhost:49407
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Content-Length: 57

{
"RollID": 1,
"Nimi": "sample string 2"
}

HTTP POST päringu vastus:
HTTP/1.1 201 Created
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Location: http://localhost:49407/Help?id=1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlccm9sbA==?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 17:05:28 GMT
Content-Length: 0

===== PUT =====
HTTP Päringu sisu:
PUT http://localhost:49407/api/roll/1 HTTP/1.1
Host: localhost:49407
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Content-Length: 55

{
"RollID": 1,
"Nimi": "new Role name"
}

HTTP Päringu vastus:
HTTP/1.1 204 No Content
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlccm9sbFwx?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 17:08:50 GMT

===== DELETE =====
...

Peale Fiddleriga läbi proovimist said retsenseerijad teada, et meeskond Leemur on realiseerinud /help controlleri, mille kaudu on võimalik ilma Fiddleri
abita kõikides controllerites realiseeritud CRUD meetodeid hõlpsasti testida. Teatavasti topelt ei kärise ja sai ka /help uuritud, kus kõik toimis kenasti.

==== Kodeerimise stiil ja parimad praktikad ====

Stiil oli okei, kommentaare võiks alati rohkem olla. Ära ei olnud märgitud viited kui oli kasutatud weebi ja õppejõudude materjali abi. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab. Controllerite osas võiks tuleviku tarbeks luua ja eraldada api controllerid ning tavalised/view eraldi kaustadesse lihtsama jälgitavuse tarbeks.
Käveri ASP.NET kodutöö kaitsmistest meelde jäänud soovitus, mida ta jõudis korrata mitmeid kordi: "Ärge kirjutage võimaluse korral koodi eesti keeles, kuna reaalses elus toimub kogu töö ainult inglise keeles."

== Klientrakendus ==

Klientrakendused peavad olema valmis ja wikilehel kirjeldatud hiljemalt 10. juuni 2013.
Retsensioonid veebiteenuste kohta peavad tehtud olema 15. juuni 2013

Klientrakendus mõnele olemasolevale veebiteenusele, võib olla teostatud veebirakendusena, Silverlight, WPF või vormirakendusena.

Variant1: teha klientrakendus enda loodud veebiteenusele

Leemur

2013-05-27T17:07:44Z

Atsernik: /* POST */

==[[Leemur|Meeskond "Leemur"]] ==
*Liikmed
**Marika Mäemets
**Rasmus Hommuk
**Mairo Puusepp
**Einar Kivisalu

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==

Et käesoleval hetkel on aktuaalne teedelagunemine ja augud tekivad igalepoole üleöö, siis on meie XML asfaldiaukude teemaline.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<teeauk>
<tänavad>
<tänav id = "CU00609359" tyyp = "tänav">
<nimi>Raja</nimi>
<pikkus yhik="meeter">856</pikkus>
<augud>
<auk id = "1">
<xkoord>6584427.3</xkoord>
<ykoord>537660</ykoord>
<sügavus yhik="meeter">0.08</sügavus>
<pindala yhik="ruutmeeter">0.4</pindala>
<teataja id = "1">
<nimi>Peeter Linnakodanik</nimi>
<roll>autojuht</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-04-10</likvideeritud>
</auk>
<auk id = "2">
<xkoord>6584348.6</xkoord>
<ykoord>537658.6</ykoord>
<sügavus yhik="meeter">0.8</sügavus>
<pindala yhik="ruutmeeter">0.54</pindala>
<teataja id = "1">
<nimi>Peeter Linnakodanik</nimi>
<roll>autojuht</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
</auk>
</augud>
</tänav>
<tänav id = "CU00464822" tyyp = "tänav">
<nimi>Ehitajate tee</nimi>
<pikkus yhik="meeter">23</pikkus>
<augud>
<auk id = "3">
<xkoord>6584526.2</xkoord>
<ykoord>537923.8</ykoord>
<sügavus yhik="meeter">0.9</sügavus>
<pindala yhik="ruutmeeter">0.5</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
<auk id = "4">
<xkoord>6584655.9</xkoord>
<ykoord>537637.5</ykoord>
<sügavus yhik="meeter">0.6</sügavus>
<pindala yhik="ruutmeeter">0.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
<auk id = "5">
<xkoord>6584532</xkoord>
<ykoord>537954.2</ykoord>
<sügavus yhik="meeter">0.6</sügavus>
<pindala yhik="ruutmeeter">1.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00464824" tyyp = "tänav">
<nimi>Sõpruse puiestee</nimi>
<pikkus yhik="meeter">4623</pikkus>
<augud>
<auk id = "6">
<xkoord>6584621.1</xkoord>
<ykoord>538267</ykoord>
<sügavus yhik="meeter">0.11</sügavus>
<pindala yhik="ruutmeeter">2.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>

<tänav id = "CU00072238" tyyp = "tänav">
<nimi>Ranna tee</nimi>
<pikkus yhik="meeter">623</pikkus>
<augud>
<auk id = "11">
<xkoord>6587966.2</xkoord>
<ykoord>531049.2</ykoord>
<sügavus yhik="meeter">0.07</sügavus>
<pindala yhik="ruutmeeter">0.25</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00072411" tyyp = "tänav">
<nimi>Ranna tee</nimi>
<pikkus yhik="meeter">1023</pikkus>
<augud>
<auk id = "12">
<xkoord>6587827.8</xkoord>
<ykoord>531034.3</ykoord>
<sügavus yhik="meeter">0.07</sügavus>
<pindala yhik="ruutmeeter">0.75</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00069699" tyyp = "maantee">
<nimi>Klooga mnt</nimi>
<pikkus yhik="meeter">623</pikkus>
<augud>
<auk id = "13">
<xkoord>6588082</xkoord>
<ykoord>531159.8</ykoord>
<sügavus yhik="meeter">0.16</sügavus>
<pindala yhik="ruutmeeter">0.75</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>

<tänav id = "CU02094396" tyyp = "tänav">
<nimi>Nõlvaku tänav</nimi>
<pikkus yhik="meeter">823</pikkus>
<augud>
<auk id = "11">
<xkoord>6579325.4</xkoord>
<ykoord>536312.7</ykoord>
<sügavus yhik="meeter">0.11</sügavus>
<pindala yhik="ruutmeeter">1.55</pindala>
<teataja id = "4">
<nimi>Ülo Vallavanem</nimi>
<roll>Vallavanem</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
</tänavad>

</teeauk>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="XMLSchema1"
targetNamespace="http://tempuri.org/teeauk.xsd"
elementFormDefault="qualified"
xmlns="http://tempuri.org/teeauk.xsd"
xmlns:mstns="http://tempuri.org/teeauk.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
>
<xs:simpleType name="yhikpikkus">
<xs:restriction base="xs:string">
<xs:enumeration value="meeter"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="yhiksygavus">
<xs:restriction base="xs:string">
<xs:enumeration value="meeter"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="yhikpindala">
<xs:restriction base="xs:string">
<xs:enumeration value="ruutmeeter"/>
</xs:restriction>
</xs:simpleType>

<xs:element name="teeauk">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs ="0" maxOccurs="unbounded" name="tänavad">
<xs:complexType>
<xs:choice>
<xs:element minOccurs ="0" maxOccurs="unbounded" name="tänav">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string"></xs:element>
<xs:element name="pikkus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:int">
<xs:attribute name="yhik" type="yhikpikkus"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="augud">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="auk">
<xs:complexType>
<xs:sequence>
<xs:element name="xkoord" type="xs:double"></xs:element>
<xs:element name="ykoord" type="xs:double"></xs:element>
<xs:element name="sügavus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:double">
<xs:attribute name="yhik" type="yhiksygavus"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="pindala">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:double">
<xs:attribute name="yhik" type="yhikpindala"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="teataja">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string"></xs:element>
<xs:element name="roll" type="xs:string"></xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:int"></xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="avastatud" type="xs:date"></xs:element>
<xs:element name="likvideeritud" type="xs:date" minOccurs ="0"></xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:int"></xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:string"></xs:attribute>
<xs:attribute name="tyyp" type="xs:string"></xs:attribute>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

</source>

=== XSLT failid ===

==Asfaldiaukude tabel==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Asfaldiaugud üle kogu maa</title>
</head>
<body>
<h1>Asfaldiaukude nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav">
<li>
<xsl:value-of select="nimi"/>
<xsl:text> </xsl:text>
<xsl:value-of select="@tyyp"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="pikkus"/>
<xsl:value-of select="@yhik"/>
<xsl:text>-</xsl:text>
<table border="1">
<th>
<td>Koordinaadid</td>
<td>Sügavus ja pindlala</td>
<td>Teavitaja</td>
<td>Avastatud</td>
<td>Likvideeritud</td>
</th>
<xsl:for-each select="augud/auk">
<tr>
<td>
<xsl:value-of select="@id" />
</td>
<td>
<xsl:text>X </xsl:text>
<xsl:value-of select="xkoord" />
<br/>
<xsl:text>Y </xsl:text>
<xsl:value-of select="ykoord" />
</td>
<td>
<xsl:value-of select="sügavus" />
<br/>
<xsl:value-of select="pindala" />
</td>
<td>
<xsl:value-of select="teataja/nimi" />
<br/>
<xsl:value-of select="teataja/roll" />
</td>
<td>
<xsl:value-of select="avastatud" />
</td>
<td>
<xsl:value-of select="likvideeritud" />
<xsl:text>.</xsl:text>
</td>
</tr>
</xsl:for-each>
</table>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==Aukudest teatajad ==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Asfaldiaugud üle kogu maa</title>
</head>
<body>
<h1>Aukudest teatajate nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav/augud/auk/teataja">
<li>
<xsl:value-of select="./nimi"/>
<xsl:text> - </xsl:text>
<xsl:value-of select="./roll"/>
<xsl:text> </xsl:text>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

== Tänavate nimekiri ==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Teede/tänavate nimekiri</title>
</head>
<body>
<h1>Teede/tänavate nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav">
<li>
<xsl:value-of select="./nimi"/>
<xsl:text> - </xsl:text>
<xsl:value-of select="./pikkus"/>
<xsl:text> meetrit </xsl:text>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

== Retsensioonid ==

=== XML ===
====XML====
XML-failis on 6 loogilist dimensiooni. Tasemete kaupa välja kirjutatuna:
tase 1: teeauk
tase 2: tänavad
tase 3: tänav (atribuudid: tüüp)
tase 4: nimi, pikkus, augud
tase 5: auk
tase 6: xkoord, ykoord, sügavus, pindala, teataja, avastatud, likvideeritud.
Atribuute on kasutatud nõuetele vastavas koguses. Taseme "tänav" juurde on loodud atribuut "tyyp", mis võib olla kas "tänav" või "maantee". Rühma Leemur oleks võinud paari sõnaga kommenteerida, miks on tänava ja maantee eristamine oluline.

====XSD====
XSD-faili põhjal võib aukudega tänavaid ka üldse mitte eksisteerida või olla piiramata arv. Põhimõtteliselt võiks tänavate arv olla piiratud mõne mõistliku numbriga, aga samas ei tohiks ka piiramata arv olla probleem.
Dimensioon "tänavad" sisaldab järgmise tasemena elemente tüübist "tänav". Miks on sealjuures taseme "tänavad" elementide kirjeldamiseks kasutatud tag'i "choise", mille sees on ainult üks element?
Dimensiooni "tänavad" elemendid peavad olema kirjeldatud kindlas järjekorras (nimi, pikkus, augud). Koodi loetavuse seisukohalt on hea, kui see nii on.
Atribuutide kirjelduses võiks ehk augu pindala ja sügavus olla lubatud kirjeldada ka vastavalt sentimeetrites ja ruutsentimeetrites.

====XSL====
XSL-faile on kokku 3, mida on rohkem kui minimaalselt nõutud- 2.
Asfaldiaukude tabel
Tabelis on augu id, koordinaadid, pindala, teataja nimi ja roll, avastamise ja likvideerimise kuupäev.
Aukudest teatajate tabel
Tabelis näidatakse teatajate nimesid ja rollisid.
Tänavate tabel
Näidatakse tänavanimesid koos tänavate pikkustega.
Mõne sõnaga võiks ehk kirjeldada, millist eesmärki html-kujule teisendatud tabelid kasutaja seisukohast võiksid täita.

Kokkuvõtvalt võib öelda, et meeskond "Leemur" on oma XML-, XSD -ja XSL-failid koostanud loogiliselt ja hästi struktureeritult.

Meeskond TeravC

--------------------

Tiim "Leemur" on pakkunud välja XML liidese definitsiooni tänavaaukude kohta käiva info edastamiseks. Teema on igati ajakohane ning antud lahendus omab ka reaalset rakendust näiteks autojuhi GPS tarkvaras. Iseasi, et andmemahu kokkuhoiu mõttes võibolla oleks kasulik terved kohad edastada aukude asemel.

Esitatud lahendus vastab kodutöös nõutud tingimustele ja ootustele keerukuse osas ning isegi ületab neid. XML faili struktuur on arusaadav ja lisakommentaare ei vaja.
Näidisena välja pakutud XSLT abil õnnestub genereerida väljund nii HTML kui XML formaadis.

Andmete grupeerimine tänavate kaupa tundub mõistlik arvestades potentsiaalse info tarbija vajadust saada infot parasjagu läbitava tänava kohta. Tänava pikkuse esitamise vajadusest ei saa hästi aru. Aukudel on ka omadus taastekkida, antud struktuur võimaldab aga esitada ühe(viimase?) teataja ning parandaja. Rakenduse võib muidugi luua selliselt, et uuesti teatades muutub parandaja väli väljund XML'is uuesti tühjaks. samas oleks hea info aukude kohta, mis pidevalt lagunevad ja parandatud saavad.

XML välja nimetuses täpitähtede kasutamine ei pruugi olla alati hea mõte, ehkki on loomulikult lubatud.

Meeskond Hops

== Veebiteenus ==

Jätkame asfaldiaukude teemaga, kuna tänavate seisukord on endiselt päevakorral olev teema ja ei ole näha, et see aktuaalsuse minetaks.

Veebiteenus peab olema valmis ja ja wikilehel kirjeldatud hiljemalt 20. mai 2013.

Retsensioonid veebiteenuste kohta peavad tehtud olema 27. mai 2013

*'''Loodav veebiteenus peab võimaldama:'''
** Teenuse pakkumist
** Teenuse kasutajate tuvastamist ning haldamist
** Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

=== plaanitav funktsionaalsus ===
- teha teenus, mis väljastab viimased lisatud augud
- teha teenus, mis väljastab valitud tänaval asuvad augud
- teha teenus, mis väljastab kõige suurema aukude arvuga tänavad (suhtes pikkusega)
- teha teenus, mis ...
- teha teenus, mis ...

=== Tööde edenemine ===
- Versioonihaldus ülesse seada - Asjassepühendatute jaoks paikneb see siin: https://leemur.visualstudio.com/ ''15.05.2013.''
- Andmebaasiserver töökorda seada (OK - Rasmus). Installeeritud MS SQL Express 12 (version 11.0.3128.0) ''16.05.2013''
- Domeeni mudel valmis teha - OK
- EF raamistik paika () - OK
- Luua standard Repod iga objekti klassi kohta (I{KlassiNimi}Repository + {KlassiNimi}Repository)
Olemas AukRepository, EFRepositories, KasutusRepository, RollRepository, TanavRepository, TeavitajaRepository

- Funktsionaalsuse teostus (Controllers) (Get + Post + Put + Delete) - OK

- Autentimine, Autoriseerimine - veidi problemaatiline.

Veebiteenuse koodi võib leida siit: http://enos.itcollege.ee/~rhommuk/Poska/Asfaldiauk.zip ''20.05.2013.''<br/>
Realiseeritud meetodite testimiseks on kasutatav aadress ~/Help

=== Veebiteenuse retsensioon - TeravC ===

==== Enne retsenseerima asumist meeskonna Leemur poolt esitatud teadaolevad puudused ====
"Retsenseerides võib kohe kirja panna, et autentimist ega kasutajate statistikat ei ole ... meil on ainult teenus lahendatud."

==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
*Andmemudeli teek (AsfaldiaukModels),
*Andme ligipääsu teek (AsfaldiaukDAL),
*Teenuse enda teostus (AsfaldiaukWebAPI).
Testide tegemiseks loodud ka konsoolirakendus AsfaldiaukTest. Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt.
Projekti luues oleks võnud "Create unit test projecti" lahtrisse linnukese teha kuid kuna antud raames me unit teste ei kirjuta siis liiga oluline see ei ole.

==== Domeeni mudel ====
Natuke on ka arusaamatu, milleks on väljaminevad seosed defineeritud eraldi klassides. Annotatsioonid on täiesti olemas kuid võiks võib-olla kohati natuke rohkem lubatud olla,
näiteks AukMall.cs public string Kommentaar lubab 50 tähemärki, mille sisse tekst "Selline pirakas teeauk, et lõhkusin autol parempoolse esiratta ja midagi veel." juba enam ära ei mahu.

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Võetud kasutusele valmiskirjutatud IEFRepository.cs + EFRepositor.cs
Dependency resolver osas kasutusel Ninject ja loodud ka vajalik dummy IAsfaldiaukContext.cs interface selle toimimiseks.
Migrations->configuration.cs all võiks internal sealed class... muuta publicuks.

==== Web API teenus ====
Peale konsoolirakenduse käivitamist ning andmete baasi saamist võis asuda ka teenust testmima. Nii konsoolirakenduse kui webAPI connectionstring oli määratud (localdb)\v11.0, mille
tõttu oli loodud baas kohe hõlpsasti leitav. Baasi loomise/muutmise osas on arendusfaasis kasutatud strateegiat DropCreateDatabaseAlways.

Web API teenus töötab, näitena: api/auk väljastab aukude nimekirja. Teenus annab andmeid JSON formaadis.
Controllerid koos vajalike CRUD meetoditega olid kohandatud vastavalt vajadustele ja loodud igale klassile.

==== Testimine ====
Kasutasin TanavController.cs klassi kuna seal olid kõik CRUD meetodid kirjeldatud:
===== GET api/tanav =====

HTTP päringu sisu:
GET http://localhost:49407/api/tanav HTTP/1.1
User-Agent: Fiddler
Host: localhost:49407

HTTP vastus päringule:
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcb2RhbGJlcmdcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlcdGFuYXY=?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 00:20:36 GMT
Content-Length: 78

[
{
"TanavID": 1,
"Nimi": "Mustamae",
"Pikkus": 3.87
}
]

===== GET api/tanav/1 =====
Sama vastus nagu eelmine.

===== GET api/tanav/2 =====
HTTP päringu sisu:
GET http://localhost:49407/api/tanav/2 HTTP/1.1
User-Agent: Fiddler
Host: localhost:49407

HTTP päringu vastus:
HTTP/1.1 404 Not Found
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcb2RhbGJlcmdcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlcdGFuYXZcMg==?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 00:23:21 GMT
Content-Length: 44

"Sellise id-ga tänavat andmebaasis ei ole!"

===== POST =====
HTTP POST päringu sisu:
POST http://localhost:49407/api/roll HTTP/1.1
Host: localhost:49407
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Content-Length: 57

{
"RollID": 1,
"Nimi": "sample string 2"
}

HTTP POST päringu vastus:
HTTP/1.1 201 Created
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Location: http://localhost:49407/Help?id=1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlccm9sbA==?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 17:05:28 GMT
Content-Length: 0

===== PUT =====
...
===== DELETE =====
...

Peale Fiddleriga läbi proovimist said retsenseerijad teada, et meeskond Leemur on realiseerinud /help controlleri, mille kaudu on võimalik ilma Fiddleri
abita kõikides controllerites realiseeritud CRUD meetodeid hõlpsasti testida. Teatavasti topelt ei kärise ja sai ka /help uuritud, kus kõik toimis kenasti.

==== Kodeerimise stiil ja parimad praktikad ====

Stiil oli okei, kommentaare võiks alati rohkem olla. Ära ei olnud märgitud viited kui oli kasutatud weebi ja õppejõudude materjali abi. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab. Controllerite osas võiks tuleviku tarbeks luua ja eraldada api controllerid ning tavalised/view eraldi kaustadesse lihtsama jälgitavuse tarbeks.
Käveri ASP.NET kodutöö kaitsmistest meelde jäänud soovitus, mida ta jõudis korrata mitmeid kordi: "Ärge kirjutage võimaluse korral koodi eesti keeles, kuna reaalses elus toimub kogu töö ainult inglise keeles."

== Klientrakendus ==

Klientrakendused peavad olema valmis ja wikilehel kirjeldatud hiljemalt 10. juuni 2013.
Retsensioonid veebiteenuste kohta peavad tehtud olema 15. juuni 2013

Klientrakendus mõnele olemasolevale veebiteenusele, võib olla teostatud veebirakendusena, Silverlight, WPF või vormirakendusena.

Variant1: teha klientrakendus enda loodud veebiteenusele

Leemur

2013-05-27T17:07:07Z

Atsernik: /* POST */

==[[Leemur|Meeskond "Leemur"]] ==
*Liikmed
**Marika Mäemets
**Rasmus Hommuk
**Mairo Puusepp
**Einar Kivisalu

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==

Et käesoleval hetkel on aktuaalne teedelagunemine ja augud tekivad igalepoole üleöö, siis on meie XML asfaldiaukude teemaline.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<teeauk>
<tänavad>
<tänav id = "CU00609359" tyyp = "tänav">
<nimi>Raja</nimi>
<pikkus yhik="meeter">856</pikkus>
<augud>
<auk id = "1">
<xkoord>6584427.3</xkoord>
<ykoord>537660</ykoord>
<sügavus yhik="meeter">0.08</sügavus>
<pindala yhik="ruutmeeter">0.4</pindala>
<teataja id = "1">
<nimi>Peeter Linnakodanik</nimi>
<roll>autojuht</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-04-10</likvideeritud>
</auk>
<auk id = "2">
<xkoord>6584348.6</xkoord>
<ykoord>537658.6</ykoord>
<sügavus yhik="meeter">0.8</sügavus>
<pindala yhik="ruutmeeter">0.54</pindala>
<teataja id = "1">
<nimi>Peeter Linnakodanik</nimi>
<roll>autojuht</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
</auk>
</augud>
</tänav>
<tänav id = "CU00464822" tyyp = "tänav">
<nimi>Ehitajate tee</nimi>
<pikkus yhik="meeter">23</pikkus>
<augud>
<auk id = "3">
<xkoord>6584526.2</xkoord>
<ykoord>537923.8</ykoord>
<sügavus yhik="meeter">0.9</sügavus>
<pindala yhik="ruutmeeter">0.5</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
<auk id = "4">
<xkoord>6584655.9</xkoord>
<ykoord>537637.5</ykoord>
<sügavus yhik="meeter">0.6</sügavus>
<pindala yhik="ruutmeeter">0.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
<auk id = "5">
<xkoord>6584532</xkoord>
<ykoord>537954.2</ykoord>
<sügavus yhik="meeter">0.6</sügavus>
<pindala yhik="ruutmeeter">1.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00464824" tyyp = "tänav">
<nimi>Sõpruse puiestee</nimi>
<pikkus yhik="meeter">4623</pikkus>
<augud>
<auk id = "6">
<xkoord>6584621.1</xkoord>
<ykoord>538267</ykoord>
<sügavus yhik="meeter">0.11</sügavus>
<pindala yhik="ruutmeeter">2.7</pindala>
<teataja id = "2">
<nimi>Jüri Kõvaametnik</nimi>
<roll>Maanteeameti kontroll</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>

<tänav id = "CU00072238" tyyp = "tänav">
<nimi>Ranna tee</nimi>
<pikkus yhik="meeter">623</pikkus>
<augud>
<auk id = "11">
<xkoord>6587966.2</xkoord>
<ykoord>531049.2</ykoord>
<sügavus yhik="meeter">0.07</sügavus>
<pindala yhik="ruutmeeter">0.25</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00072411" tyyp = "tänav">
<nimi>Ranna tee</nimi>
<pikkus yhik="meeter">1023</pikkus>
<augud>
<auk id = "12">
<xkoord>6587827.8</xkoord>
<ykoord>531034.3</ykoord>
<sügavus yhik="meeter">0.07</sügavus>
<pindala yhik="ruutmeeter">0.75</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
<tänav id = "CU00069699" tyyp = "maantee">
<nimi>Klooga mnt</nimi>
<pikkus yhik="meeter">623</pikkus>
<augud>
<auk id = "13">
<xkoord>6588082</xkoord>
<ykoord>531159.8</ykoord>
<sügavus yhik="meeter">0.16</sügavus>
<pindala yhik="ruutmeeter">0.75</pindala>
<teataja id = "3">
<nimi>Mari Vallaametnik</nimi>
<roll>Vallavalitsuse insener</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>

<tänav id = "CU02094396" tyyp = "tänav">
<nimi>Nõlvaku tänav</nimi>
<pikkus yhik="meeter">823</pikkus>
<augud>
<auk id = "11">
<xkoord>6579325.4</xkoord>
<ykoord>536312.7</ykoord>
<sügavus yhik="meeter">0.11</sügavus>
<pindala yhik="ruutmeeter">1.55</pindala>
<teataja id = "4">
<nimi>Ülo Vallavanem</nimi>
<roll>Vallavanem</roll>
</teataja>
<avastatud>2013-02-15</avastatud>
<likvideeritud>2013-02-15</likvideeritud>
</auk>
</augud>
</tänav>
</tänavad>

</teeauk>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="XMLSchema1"
targetNamespace="http://tempuri.org/teeauk.xsd"
elementFormDefault="qualified"
xmlns="http://tempuri.org/teeauk.xsd"
xmlns:mstns="http://tempuri.org/teeauk.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
>
<xs:simpleType name="yhikpikkus">
<xs:restriction base="xs:string">
<xs:enumeration value="meeter"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="yhiksygavus">
<xs:restriction base="xs:string">
<xs:enumeration value="meeter"/>
</xs:restriction>
</xs:simpleType>

<xs:simpleType name="yhikpindala">
<xs:restriction base="xs:string">
<xs:enumeration value="ruutmeeter"/>
</xs:restriction>
</xs:simpleType>

<xs:element name="teeauk">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs ="0" maxOccurs="unbounded" name="tänavad">
<xs:complexType>
<xs:choice>
<xs:element minOccurs ="0" maxOccurs="unbounded" name="tänav">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string"></xs:element>
<xs:element name="pikkus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:int">
<xs:attribute name="yhik" type="yhikpikkus"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="augud">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="auk">
<xs:complexType>
<xs:sequence>
<xs:element name="xkoord" type="xs:double"></xs:element>
<xs:element name="ykoord" type="xs:double"></xs:element>
<xs:element name="sügavus">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:double">
<xs:attribute name="yhik" type="yhiksygavus"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="pindala">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:double">
<xs:attribute name="yhik" type="yhikpindala"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
<xs:element name="teataja">
<xs:complexType>
<xs:sequence>
<xs:element name="nimi" type="xs:string"></xs:element>
<xs:element name="roll" type="xs:string"></xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:int"></xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="avastatud" type="xs:date"></xs:element>
<xs:element name="likvideeritud" type="xs:date" minOccurs ="0"></xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:int"></xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="id" type="xs:string"></xs:attribute>
<xs:attribute name="tyyp" type="xs:string"></xs:attribute>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

</source>

=== XSLT failid ===

==Asfaldiaukude tabel==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Asfaldiaugud üle kogu maa</title>
</head>
<body>
<h1>Asfaldiaukude nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav">
<li>
<xsl:value-of select="nimi"/>
<xsl:text> </xsl:text>
<xsl:value-of select="@tyyp"/>
<xsl:text>-</xsl:text>
<xsl:value-of select="pikkus"/>
<xsl:value-of select="@yhik"/>
<xsl:text>-</xsl:text>
<table border="1">
<th>
<td>Koordinaadid</td>
<td>Sügavus ja pindlala</td>
<td>Teavitaja</td>
<td>Avastatud</td>
<td>Likvideeritud</td>
</th>
<xsl:for-each select="augud/auk">
<tr>
<td>
<xsl:value-of select="@id" />
</td>
<td>
<xsl:text>X </xsl:text>
<xsl:value-of select="xkoord" />
<br/>
<xsl:text>Y </xsl:text>
<xsl:value-of select="ykoord" />
</td>
<td>
<xsl:value-of select="sügavus" />
<br/>
<xsl:value-of select="pindala" />
</td>
<td>
<xsl:value-of select="teataja/nimi" />
<br/>
<xsl:value-of select="teataja/roll" />
</td>
<td>
<xsl:value-of select="avastatud" />
</td>
<td>
<xsl:value-of select="likvideeritud" />
<xsl:text>.</xsl:text>
</td>
</tr>
</xsl:for-each>
</table>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==Aukudest teatajad ==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="html" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Asfaldiaugud üle kogu maa</title>
</head>
<body>
<h1>Aukudest teatajate nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav/augud/auk/teataja">
<li>
<xsl:value-of select="./nimi"/>
<xsl:text> - </xsl:text>
<xsl:value-of select="./roll"/>
<xsl:text> </xsl:text>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

== Tänavate nimekiri ==

<source lang="xml">

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>Teede/tänavate nimekiri</title>
</head>
<body>
<h1>Teede/tänavate nimekiri</h1>
<ul>
<xsl:for-each select="/teeauk/tänavad/tänav">
<li>
<xsl:value-of select="./nimi"/>
<xsl:text> - </xsl:text>
<xsl:value-of select="./pikkus"/>
<xsl:text> meetrit </xsl:text>
</li>
</xsl:for-each>
</ul>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

== Retsensioonid ==

=== XML ===
====XML====
XML-failis on 6 loogilist dimensiooni. Tasemete kaupa välja kirjutatuna:
tase 1: teeauk
tase 2: tänavad
tase 3: tänav (atribuudid: tüüp)
tase 4: nimi, pikkus, augud
tase 5: auk
tase 6: xkoord, ykoord, sügavus, pindala, teataja, avastatud, likvideeritud.
Atribuute on kasutatud nõuetele vastavas koguses. Taseme "tänav" juurde on loodud atribuut "tyyp", mis võib olla kas "tänav" või "maantee". Rühma Leemur oleks võinud paari sõnaga kommenteerida, miks on tänava ja maantee eristamine oluline.

====XSD====
XSD-faili põhjal võib aukudega tänavaid ka üldse mitte eksisteerida või olla piiramata arv. Põhimõtteliselt võiks tänavate arv olla piiratud mõne mõistliku numbriga, aga samas ei tohiks ka piiramata arv olla probleem.
Dimensioon "tänavad" sisaldab järgmise tasemena elemente tüübist "tänav". Miks on sealjuures taseme "tänavad" elementide kirjeldamiseks kasutatud tag'i "choise", mille sees on ainult üks element?
Dimensiooni "tänavad" elemendid peavad olema kirjeldatud kindlas järjekorras (nimi, pikkus, augud). Koodi loetavuse seisukohalt on hea, kui see nii on.
Atribuutide kirjelduses võiks ehk augu pindala ja sügavus olla lubatud kirjeldada ka vastavalt sentimeetrites ja ruutsentimeetrites.

====XSL====
XSL-faile on kokku 3, mida on rohkem kui minimaalselt nõutud- 2.
Asfaldiaukude tabel
Tabelis on augu id, koordinaadid, pindala, teataja nimi ja roll, avastamise ja likvideerimise kuupäev.
Aukudest teatajate tabel
Tabelis näidatakse teatajate nimesid ja rollisid.
Tänavate tabel
Näidatakse tänavanimesid koos tänavate pikkustega.
Mõne sõnaga võiks ehk kirjeldada, millist eesmärki html-kujule teisendatud tabelid kasutaja seisukohast võiksid täita.

Kokkuvõtvalt võib öelda, et meeskond "Leemur" on oma XML-, XSD -ja XSL-failid koostanud loogiliselt ja hästi struktureeritult.

Meeskond TeravC

--------------------

Tiim "Leemur" on pakkunud välja XML liidese definitsiooni tänavaaukude kohta käiva info edastamiseks. Teema on igati ajakohane ning antud lahendus omab ka reaalset rakendust näiteks autojuhi GPS tarkvaras. Iseasi, et andmemahu kokkuhoiu mõttes võibolla oleks kasulik terved kohad edastada aukude asemel.

Esitatud lahendus vastab kodutöös nõutud tingimustele ja ootustele keerukuse osas ning isegi ületab neid. XML faili struktuur on arusaadav ja lisakommentaare ei vaja.
Näidisena välja pakutud XSLT abil õnnestub genereerida väljund nii HTML kui XML formaadis.

Andmete grupeerimine tänavate kaupa tundub mõistlik arvestades potentsiaalse info tarbija vajadust saada infot parasjagu läbitava tänava kohta. Tänava pikkuse esitamise vajadusest ei saa hästi aru. Aukudel on ka omadus taastekkida, antud struktuur võimaldab aga esitada ühe(viimase?) teataja ning parandaja. Rakenduse võib muidugi luua selliselt, et uuesti teatades muutub parandaja väli väljund XML'is uuesti tühjaks. samas oleks hea info aukude kohta, mis pidevalt lagunevad ja parandatud saavad.

XML välja nimetuses täpitähtede kasutamine ei pruugi olla alati hea mõte, ehkki on loomulikult lubatud.

Meeskond Hops

== Veebiteenus ==

Jätkame asfaldiaukude teemaga, kuna tänavate seisukord on endiselt päevakorral olev teema ja ei ole näha, et see aktuaalsuse minetaks.

Veebiteenus peab olema valmis ja ja wikilehel kirjeldatud hiljemalt 20. mai 2013.

Retsensioonid veebiteenuste kohta peavad tehtud olema 27. mai 2013

*'''Loodav veebiteenus peab võimaldama:'''
** Teenuse pakkumist
** Teenuse kasutajate tuvastamist ning haldamist
** Teenuse kasutajate ja kasutusstatistika üle arve pidamist kasutajate lõikes

Soovitav on luua teenus (FE) ja teenuse seadistamiseks ning kasutajate haldamiseks mõeldud rakendus (BE).

=== plaanitav funktsionaalsus ===
- teha teenus, mis väljastab viimased lisatud augud
- teha teenus, mis väljastab valitud tänaval asuvad augud
- teha teenus, mis väljastab kõige suurema aukude arvuga tänavad (suhtes pikkusega)
- teha teenus, mis ...
- teha teenus, mis ...

=== Tööde edenemine ===
- Versioonihaldus ülesse seada - Asjassepühendatute jaoks paikneb see siin: https://leemur.visualstudio.com/ ''15.05.2013.''
- Andmebaasiserver töökorda seada (OK - Rasmus). Installeeritud MS SQL Express 12 (version 11.0.3128.0) ''16.05.2013''
- Domeeni mudel valmis teha - OK
- EF raamistik paika () - OK
- Luua standard Repod iga objekti klassi kohta (I{KlassiNimi}Repository + {KlassiNimi}Repository)
Olemas AukRepository, EFRepositories, KasutusRepository, RollRepository, TanavRepository, TeavitajaRepository

- Funktsionaalsuse teostus (Controllers) (Get + Post + Put + Delete) - OK

- Autentimine, Autoriseerimine - veidi problemaatiline.

Veebiteenuse koodi võib leida siit: http://enos.itcollege.ee/~rhommuk/Poska/Asfaldiauk.zip ''20.05.2013.''<br/>
Realiseeritud meetodite testimiseks on kasutatav aadress ~/Help

=== Veebiteenuse retsensioon - TeravC ===

==== Enne retsenseerima asumist meeskonna Leemur poolt esitatud teadaolevad puudused ====
"Retsenseerides võib kohe kirja panna, et autentimist ega kasutajate statistikat ei ole ... meil on ainult teenus lahendatud."

==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
*Andmemudeli teek (AsfaldiaukModels),
*Andme ligipääsu teek (AsfaldiaukDAL),
*Teenuse enda teostus (AsfaldiaukWebAPI).
Testide tegemiseks loodud ka konsoolirakendus AsfaldiaukTest. Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt.
Projekti luues oleks võnud "Create unit test projecti" lahtrisse linnukese teha kuid kuna antud raames me unit teste ei kirjuta siis liiga oluline see ei ole.

==== Domeeni mudel ====
Natuke on ka arusaamatu, milleks on väljaminevad seosed defineeritud eraldi klassides. Annotatsioonid on täiesti olemas kuid võiks võib-olla kohati natuke rohkem lubatud olla,
näiteks AukMall.cs public string Kommentaar lubab 50 tähemärki, mille sisse tekst "Selline pirakas teeauk, et lõhkusin autol parempoolse esiratta ja midagi veel." juba enam ära ei mahu.

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Võetud kasutusele valmiskirjutatud IEFRepository.cs + EFRepositor.cs
Dependency resolver osas kasutusel Ninject ja loodud ka vajalik dummy IAsfaldiaukContext.cs interface selle toimimiseks.
Migrations->configuration.cs all võiks internal sealed class... muuta publicuks.

==== Web API teenus ====
Peale konsoolirakenduse käivitamist ning andmete baasi saamist võis asuda ka teenust testmima. Nii konsoolirakenduse kui webAPI connectionstring oli määratud (localdb)\v11.0, mille
tõttu oli loodud baas kohe hõlpsasti leitav. Baasi loomise/muutmise osas on arendusfaasis kasutatud strateegiat DropCreateDatabaseAlways.

Web API teenus töötab, näitena: api/auk väljastab aukude nimekirja. Teenus annab andmeid JSON formaadis.
Controllerid koos vajalike CRUD meetoditega olid kohandatud vastavalt vajadustele ja loodud igale klassile.

==== Testimine ====
Kasutasin TanavController.cs klassi kuna seal olid kõik CRUD meetodid kirjeldatud:
===== GET api/tanav =====

HTTP päringu sisu:
GET http://localhost:49407/api/tanav HTTP/1.1
User-Agent: Fiddler
Host: localhost:49407

HTTP vastus päringule:
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcb2RhbGJlcmdcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlcdGFuYXY=?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 00:20:36 GMT
Content-Length: 78

[
{
"TanavID": 1,
"Nimi": "Mustamae",
"Pikkus": 3.87
}
]

===== GET api/tanav/1 =====
Sama vastus nagu eelmine.

===== GET api/tanav/2 =====
HTTP päringu sisu:
GET http://localhost:49407/api/tanav/2 HTTP/1.1
User-Agent: Fiddler
Host: localhost:49407

HTTP päringu vastus:
HTTP/1.1 404 Not Found
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcb2RhbGJlcmdcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlcdGFuYXZcMg==?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 00:23:21 GMT
Content-Length: 44

"Sellise id-ga tänavat andmebaasis ei ole!"

===== POST =====
POST http://localhost:49407/api/roll HTTP/1.1
Host: localhost:49407
User-Agent: Fiddler
Content-Type: text/json
Accept: text/json
Content-Length: 57

{
"RollID": 1,
"Nimi": "sample string 2"
}

HTTP/1.1 201 Created
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Location: http://localhost:49407/Help?id=1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxBc2ZhbGRpYXVrXEFzZmFsZGlhdWtUZWVudXNcQXNmYWxkaWF1a1dlYkFQSVxhcGlccm9sbA==?=
X-Powered-By: ASP.NET
Date: Mon, 27 May 2013 17:05:28 GMT
Content-Length: 0

===== PUT =====
...
===== DELETE =====
...

Peale Fiddleriga läbi proovimist said retsenseerijad teada, et meeskond Leemur on realiseerinud /help controlleri, mille kaudu on võimalik ilma Fiddleri
abita kõikides controllerites realiseeritud CRUD meetodeid hõlpsasti testida. Teatavasti topelt ei kärise ja sai ka /help uuritud, kus kõik toimis kenasti.

==== Kodeerimise stiil ja parimad praktikad ====

Stiil oli okei, kommentaare võiks alati rohkem olla. Ära ei olnud märgitud viited kui oli kasutatud weebi ja õppejõudude materjali abi. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab. Controllerite osas võiks tuleviku tarbeks luua ja eraldada api controllerid ning tavalised/view eraldi kaustadesse lihtsama jälgitavuse tarbeks.
Käveri ASP.NET kodutöö kaitsmistest meelde jäänud soovitus, mida ta jõudis korrata mitmeid kordi: "Ärge kirjutage võimaluse korral koodi eesti keeles, kuna reaalses elus toimub kogu töö ainult inglise keeles."

== Klientrakendus ==

Klientrakendused peavad olema valmis ja wikilehel kirjeldatud hiljemalt 10. juuni 2013.
Retsensioonid veebiteenuste kohta peavad tehtud olema 15. juuni 2013

Klientrakendus mõnele olemasolevale veebiteenusele, võib olla teostatud veebirakendusena, Silverlight, WPF või vormirakendusena.

Variant1: teha klientrakendus enda loodud veebiteenusele

Terav C - Võrgurakendused 2 - projektileht

2013-05-27T16:38:03Z

Atsernik: /* Uue objekti loomine */

Terav C - Võrgurakendused 2 - projektileht

2013-05-26T18:19:16Z

Atsernik: /* Ülesanne 2 - Veebiteenus */

Hops

2013-05-26T15:03:27Z

Atsernik: /* TESTI KIRJELDUS 2 - Vastus JSON-formaadis */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Esimese asjana märkasin ja võibolla abiks ka õppejõule, et ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Seejärel alles saab asuma WEB API testimist.

===== Teenusest endast =====
Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. CRUD operatsioonidest on esindatud retsensiooni kirjutamise hetkel R-Read.

Osaliselt on teostatud CurrencyController. HomeController ja ValuesController on jäänud sinna projekti templeidist.

Vaikimisi väljastab teenus andmed xml-formaadis. Kui GET päringu päisesse panna Accept "text/json", siis väljastab JSON formaadis.

===== TESTI KIRJELDUS 1 - Vastus XML-formaadis =====

HTTP päringu päis:
GET http://localhost:5189/api/currency HTTP/1.1
Host: localhost:5189
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:20.0) Gecko/20100101 Firefox/20.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Connection: keep-alive

HTTP vastus päringule:
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/xml; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxjdXJyZW5jeS1jb252ZXJ0ZXItbWFzdGVyXGN1cnJlbmN5LWNvbnZlcnRlci1tYXN0ZXJcQVNQTkVUTVZDU2VydmljZVxhcGlcY3VycmVuY3k=?=
X-Powered-By: ASP.NET
Date: Sun, 26 May 2013 14:46:47 GMT
Content-Length: 483

<ArrayOfCurrency xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CurrencyModelsLibrary.Models"><Currency><Created>2013-05-26T16:07:49.987</Created><CreatorUser i:nil="true" /><CurrencyID>1</CurrencyID><IsVisible>true</IsVisible><Name>EUR</Name></Currency><Currency><Created>2013-05-26T16:07:49.99</Created><CreatorUser i:nil="true" /><CurrencyID>2</CurrencyID><IsVisible>true</IsVisible><Name>USD</Name></Currency></ArrayOfCurrency>

===== TESTI KIRJELDUS 2 - Vastus JSON-formaadis =====
HTTP päringu päise sisu:
GET http://localhost:5189/api/currency HTTP/1.1
Host: localhost:5189
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:20.0) Gecko/20100101 Firefox/20.0
Accept: text/json

HTTP vastus päringule:
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: text/json; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxjdXJyZW5jeS1jb252ZXJ0ZXItbWFzdGVyXGN1cnJlbmN5LWNvbnZlcnRlci1tYXN0ZXJcQVNQTkVUTVZDU2VydmljZVxhcGlcY3VycmVuY3k=?=
X-Powered-By: ASP.NET
Date: Sun, 26 May 2013 14:39:57 GMT
Content-Length: 292

[
{
"CurrencyID": 1,
"Name": "EUR",
"IsVisible": true,
"Created": "2013-05-26T16:07:49.987",
"CreatorUser": null
},
{
"CurrencyID": 2,
"Name": "USD",
"IsVisible": true,
"Created": "2013-05-26T16:07:49.99",
"CreatorUser": null
}
]

===== Logimine =====
Logimise jaoks oli eeldus loodud. Vajalikud koodiread failides Filters/WebAPIActionLoggingAttribute.cs ja Modules/MyModule1.cs oli välja kommenteeritud. Retsensenseeriad ei hakanud kommentaare eemaldama ning logimise osa testima.

===== Kasutajate audentimisest ja autoriseerimisest =====
Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:59:23Z

Atsernik: /* TESTI KIRJELDUS 1 - Vastus XML-formaadis */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Esimese asjana märkasin ja võibolla abiks ka õppejõule, et ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Seejärel alles saab asuma WEB API testimist.

===== Teenusest endast =====
Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. CRUD operatsioonidest on esindatud retsensiooni kirjutamise hetkel R-Read.

Osaliselt on teostatud CurrencyController. HomeController ja ValuesController on jäänud sinna projekti templeidist.

Vaikimisi väljastab teenus andmed xml-formaadis. Kui GET päringu päisesse panna Accept "text/json", siis väljastab JSON formaadis.

===== TESTI KIRJELDUS 1 - Vastus XML-formaadis =====

HTTP päringu päis:
GET http://localhost:5189/api/currency HTTP/1.1
Host: localhost:5189
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:20.0) Gecko/20100101 Firefox/20.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Connection: keep-alive

HTTP vastus päringule:
HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/xml; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcQW5kcmVcRGVza3RvcFxjdXJyZW5jeS1jb252ZXJ0ZXItbWFzdGVyXGN1cnJlbmN5LWNvbnZlcnRlci1tYXN0ZXJcQVNQTkVUTVZDU2VydmljZVxhcGlcY3VycmVuY3k=?=
X-Powered-By: ASP.NET
Date: Sun, 26 May 2013 14:46:47 GMT
Content-Length: 483

<ArrayOfCurrency xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CurrencyModelsLibrary.Models"><Currency><Created>2013-05-26T16:07:49.987</Created><CreatorUser i:nil="true" /><CurrencyID>1</CurrencyID><IsVisible>true</IsVisible><Name>EUR</Name></Currency><Currency><Created>2013-05-26T16:07:49.99</Created><CreatorUser i:nil="true" /><CurrencyID>2</CurrencyID><IsVisible>true</IsVisible><Name>USD</Name></Currency></ArrayOfCurrency>

===== TESTI KIRJELDUS 2 - Vastus JSON-formaadis =====

===== Logimine =====
Logimise jaoks oli eeldus loodud. Vajalikud koodiread failides Filters/WebAPIActionLoggingAttribute.cs ja Modules/MyModule1.cs oli välja kommenteeritud. Retsensenseeriad ei hakanud kommentaare eemaldama ning logimise osa testima.

===== Kasutajate audentimisest ja autoriseerimisest =====
Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:50:02Z

Atsernik: /* TESTI KIRJELDUS 1 - Vastus XML-formaadis */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Esimese asjana märkasin ja võibolla abiks ka õppejõule, et ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Seejärel alles saab asuma WEB API testimist.

===== Teenusest endast =====
Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. CRUD operatsioonidest on esindatud retsensiooni kirjutamise hetkel R-Read.

Osaliselt on teostatud CurrencyController. HomeController ja ValuesController on jäänud sinna projekti templeidist.

Vaikimisi väljastab teenus andmed xml-formaadis. Kui GET päringu päisesse panna Accept "text/json", siis väljastab JSON formaadis.

===== TESTI KIRJELDUS 1 - Vastus XML-formaadis =====

HTTP - päis:
GET http://localhost:5189/api/currency HTTP/1.1
Host: localhost:5189
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:20.0) Gecko/20100101 Firefox/20.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Connection: keep-alive

===== TESTI KIRJELDUS 2 - Vastus JSON-formaadis =====

===== Logimine =====
Logimise jaoks oli eeldus loodud. Vajalikud koodiread failides Filters/WebAPIActionLoggingAttribute.cs ja Modules/MyModule1.cs oli välja kommenteeritud. Retsensenseeriad ei hakanud kommentaare eemaldama ning logimise osa testima.

===== Kasutajate audentimisest ja autoriseerimisest =====
Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:43:49Z

Atsernik: /* Teenusest endast */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Esimese asjana märkasin ja võibolla abiks ka õppejõule, et ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Seejärel alles saab asuma WEB API testimist.

===== Teenusest endast =====
Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. CRUD operatsioonidest on esindatud retsensiooni kirjutamise hetkel R-Read.

Osaliselt on teostatud CurrencyController. HomeController ja ValuesController on jäänud sinna projekti templeidist.

Vaikimisi väljastab teenus andmed xml-formaadis. Kui GET päringu päisesse panna Accept "text/json", siis väljastab JSON formaadis.

===== TESTI KIRJELDUS 1 - Vastus XML-formaadis =====

===== TESTI KIRJELDUS 2 - Vastus JSON-formaadis =====

===== Logimine =====
Logimise jaoks oli eeldus loodud. Vajalikud koodiread failides Filters/WebAPIActionLoggingAttribute.cs ja Modules/MyModule1.cs oli välja kommenteeritud. Retsensenseeriad ei hakanud kommentaare eemaldama ning logimise osa testima.

===== Kasutajate audentimisest ja autoriseerimisest =====
Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:42:07Z

Atsernik: /* Teenusest endast */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Esimese asjana märkasin ja võibolla abiks ka õppejõule, et ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Seejärel alles saab asuma WEB API testimist.

===== Teenusest endast =====
Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. CRUD operatsioonidest on esindatud retsensiooni kirjutamise hetkel R-Read.

Osaliselt on teostatud CurrencyController. HomeController ja ValuesController on jäänud sinna projekti templeidist.

Vaikimisi väljastab teenus andmed xml-formaadis. Kui GET päringu päisesse panna Accept "text/json", siis väljastab JSON formaadis.

===== Logimine =====
Logimise jaoks oli eeldus loodud. Vajalikud koodiread failides Filters/WebAPIActionLoggingAttribute.cs ja Modules/MyModule1.cs oli välja kommenteeritud. Retsensenseeriad ei hakanud kommentaare eemaldama ning logimise osa testima.

===== Kasutajate audentimisest ja autoriseerimisest =====
Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:38:28Z

Atsernik: /* Web API teenus */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Esimese asjana märkasin ja võibolla abiks ka õppejõule, et ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Seejärel alles saab asuma WEB API testimist.

===== Teenusest endast =====
Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. CRUD operatsioonidest on esindatud retsensiooni kirjutamise hetkel R-Read.

Osaliselt on teostatud CurrencyController. HomeController ja ValuesController on jäänud sinna projekti templeidist.

Vaikimisi väljastab teenus andmed xml-formaadis.

===== Logimine =====
Logimise jaoks oli eeldus loodud. Vajalikud koodiread failides Filters/WebAPIActionLoggingAttribute.cs ja Modules/MyModule1.cs oli välja kommenteeritud. Retsensenseeriad ei hakanud kommentaare eemaldama ning logimise osa testima.

===== Kasutajate audentimisest ja autoriseerimisest =====
Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:36:33Z

Atsernik: /* Teenusest endast */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Esimese asjana märkasin ja võibolla abiks ka õppejõule, et ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Seejärel alles saab asuma WEB API testimist.

===== Teenusest endast =====
Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. CRUD operatsioonidest on esindatud retsensiooni kirjutamise hetkel R-Read.

Osaliselt on teostatud CurrencyController. HomeController ja ValuesController on jäänud sinna projekti templeidist.

===== Logimine =====
Logimise jaoks oli eeldus loodud. Vajalikud koodiread failides Filters/WebAPIActionLoggingAttribute.cs ja Modules/MyModule1.cs oli välja kommenteeritud. Retsensenseeriad ei hakanud kommentaare eemaldama ning logimise osa testima.

===== Kasutajate audentimisest ja autoriseerimisest =====
Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:34:32Z

Atsernik: /* Web API teenus */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Esimese asjana märkasin ja võibolla abiks ka õppejõule, et ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Seejärel alles saab asuma WEB API testimist.

===== Teenusest endast =====
Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. CRUD operatsioonidest on esindatud retsensiooni kirjutamise hetkel R-Read.

===== Logimine =====
Logimise jaoks oli eeldus loodud. Vajalikud koodiread failides Filters/WebAPIActionLoggingAttribute.cs ja Modules/MyModule1.cs oli välja kommenteeritud. Retsensenseeriad ei hakanud kommentaare eemaldama ning logimise osa testima.

===== Kasutajate audentimisest ja autoriseerimisest =====
Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:22:16Z

Atsernik: /* Andmeligipääsu kiht */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

Repository poole pealt võiks välja tuua selle, et eeldatud, on et iga objekti repodel on ühesugused meetodid. Projekti edasi arenendes võib see saada pudelikaelaks.

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:15:16Z

Atsernik: /* Andmeligipääsu kiht */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Pisut Internetis ringi kolades, võin öelda, et Factory meetod on pigem klassikaline, ning Dependency Resolver uuemat laadi. Antud lahenduse skoobis, antud tehnikate vahe ei löö välja, aga kui projekt areneb, arvan et Factory meetod võib saada pudelikaelaks.

Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:09:54Z

Atsernik: /* Andmeligipääsu kiht */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt:
* Cascade On-Delete seadistamine (Antud võimalust otsisid taga ka retsensiooni autorid. Aitähh :) )
* Välja kommenteerituna, aga siiski. Kurikuulusatest S-idest lahti, mis iga olemi nime lõppu EF topib.
*
*

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:05:59Z

Atsernik: /* Kodeerimise stiil ja parimad praktikad */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt.

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Ära on märgitud viited kui kasutatud weebi ja õppejõudude materjali abi.
Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik. Iga projekti Referencide nimekirja vaadates ei hakanud midagi kummalist silma, kõik on selliselt nagu peab.

Hops

2013-05-26T14:03:48Z

Atsernik: /* Arhitektuuriline ja tehnoloogiline ülesehitus */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt. Visual Studio solution-failis on eraldi projektina ka WCF-rakendus (WcfService), mis stub'ina ootab tuleviku teostust.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt.

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik.

Hops

2013-05-26T14:01:29Z

Atsernik: /* Arhitektuuriline ja tehnoloogiline ülesehitus */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldi seisvad projektid eri otstarbega teekidena:
* andmemudeli teegi (CurrencyModelsLibrary),
* andme ligipääsu teegi (CurrencyDAL),
* teenuse enda teostuse (ASPNETMVCService).

Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt.

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik.

Hops

2013-05-26T13:54:09Z

Atsernik: /* Kodeerimise stiil ja parimad praktikad */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldades projektidena andmemudeli teegi, andme ligipääsu teegi ning teenuse enda teostuse. Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt.

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Meeldib, et lahendusele on lähenetud minimalistliku printsiibiga: Teha mustris võimalikult vähe muudatusi kui võimalik.

Hops

2013-05-26T13:53:32Z

Atsernik: /* Web API teenus */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldades projektidena andmemudeli teegi, andme ligipääsu teegi ning teenuse enda teostuse. Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt.

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

==== Kodeerimise stiil ja parimad praktikad ====
Stiil on puhas, vajalikud ja ebaselged kohad ära kommenteeritud. Meeldib, et lahendusele on lähenetud minimalistliku printsiibina: Teha mustris võimalikult vähe muudatusi kui võimalik.

Hops

2013-05-26T13:45:23Z

Atsernik: /* Web API teenus */

== Meeskond ==

* Liikmed:
** Artur Hokkonen
** Margus Parts
** Hanno Sirkel
** Lauri Õunmaa

[[Category:Kodutöö aines "Võrgurakendused II: hajussüsteemide ehitamine" 2013(kaugõpe)]]

== Idee ==
Luua 4-tasemeline XML definitsioon, näidis sellele ning transleerimised HTML ja XML formaati.

== XML ==

=== XML fail ===

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<tns:autod xmlns:tns="http://www.example.org/autod" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.org/autod autod.xsd ">
<tns:auto id="0" mark="Ford" mudel="Sierra">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="punane"/>
</tns:auto>

<tns:auto id="1" mark="ZAZ" mudel="969">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="roheline"/>
</tns:auto>

<tns:auto id="2" mark="Saab" mudel="9-5">
<tns:mootor>
<tns:kytus>bensiin</tns:kytus>
<tns:kubatuur yhik="ccm">1500</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="3" mark="Volvo" mudel="960">
<tns:mootor>
<tns:kytus>elekter</tns:kytus>
</tns:mootor>
<tns:kere v2rv="sinine"/>
</tns:auto>

<tns:auto id="4" mark="Volvo" mudel="V40">
<tns:mootor>
<tns:kytus>diisel</tns:kytus>
<tns:kubatuur yhik="ccm">2400</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="must"/>
</tns:auto>

<tns:auto id="5" mark="Volvo" mudel="V70">
<tns:mootor>
<tns:kytus>gaas</tns:kytus>
<tns:kubatuur yhik="ccm">2000</tns:kubatuur>
</tns:mootor>
<tns:kere v2rv="valge"/>
</tns:auto>

</tns:autod>

</source>

=== XSD fail ===

<source lang="xml">

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.example.org/autod"
xmlns:tns="http://www.example.org/autod"
elementFormDefault="qualified">

<simpleType name="kytusSimpleType">
<restriction base="string">
<enumeration value="bensiin"></enumeration>
<enumeration value="diisel"></enumeration>
<enumeration value="elekter"></enumeration>
</restriction>
</simpleType>

<complexType name="mootorComplexType">
<sequence>
<element name="kytus" type="tns:kytusSimpleType"
maxOccurs="1" minOccurs="0">
</element>
<element name="kubatuur" maxOccurs="1" minOccurs="0">
<complexType>
<simpleContent>
<extension base="int">
<attribute name="yhik" use="required">
<simpleType>
<restriction base="string">
<enumeration value="ccm"/>
<enumeration value="l"/>
</restriction>
</simpleType>
</attribute>
</extension>
</simpleContent>
</complexType>
</element>
</sequence>
</complexType>

<complexType name="autoComplexType">
<sequence>
<element name="mootor" type="tns:mootorComplexType"></element>
<element name="kere" type="tns:kereComplexType"
maxOccurs="1" minOccurs="1">
</element>
</sequence>
<attribute name="id" type="int"></attribute>
<attribute name="mark" type="string"></attribute>
<attribute name="mudel" type="string"></attribute>
</complexType>

<simpleType name="v2rvSimpleType">
<restriction base="string">
<enumeration value="punane"></enumeration>
<enumeration value="roheline"></enumeration>
<enumeration value="sinine"></enumeration>
</restriction>
</simpleType>

<complexType name="kereComplexType">
<attribute name="v2rv" type="tns:v2rvSimpleType"></attribute>
</complexType>

<element name="autod" type="tns:AutodListComplexType"></element>

<complexType name="AutodListComplexType">
<sequence>
<element name="auto" type="tns:autoComplexType" maxOccurs="unbounded" minOccurs="0"></element>
</sequence>
</complexType>
</schema>

</source>

=== XSLT failid ===
==== XML -> HTML ====
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">

<xsl:output encoding="UTF-8" method="html" />

<xsl:template match="/">
<html>
<body>

<h2>Autode nimekiri</h2>

<table border="1">
<tr><td>Mark</td><td>Mudel</td><td>Värv</td><td>Mootor</td></tr>
<xsl:for-each select="tns:autod/tns:auto">
<tr>
<td><xsl:value-of select="@mark"/></td>
<td><xsl:value-of select="@mudel"/></td>
<td><xsl:value-of select="tns:kere/@v2rv"/></td>
<td><xsl:value-of select="tns:mootor/tns:kytus"/> <xsl:text> </xsl:text> <xsl:value-of select="tns:mootor/tns:kubatuur"/><xsl:value-of select="tns:mootor/tns:kubatuur/@yhik"/></td>
</tr>
<p> </p>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>

</source>

==== XML -> XML ====
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:tns="http://www.example.org/autod">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="/">
<tns:autod>

<xsl:for-each select="tns:autod/tns:auto">
<xsl:if test="@mark='Volvo'">
<auto>
<mark>
<xsl:value-of select="@mark"/>
</mark>
<mudel>
<xsl:value-of select="@mudel"/>
</mudel>
</auto>
</xsl:if>
</xsl:for-each>
</tns:autod>
</xsl:template>
</xsl:stylesheet>
</source>

== Veebiteenus ==

Tähtajaks tehtud osa ("''deadline''" branch):

https://github.com/onu/currency-converter/tree/deadline1

"''Master''" branch:

https://github.com/onu/currency-converter

== Retsensioonid ==

=== XML ===
Meeskond Hops on loonud xml vormingus faili autode teemal. Xml failil on neli loogilist dimensiooni ning kolmel neist on kasutatud atribuute, mis on enamat, kui lihtsalt id. Lisaks xml failile on loodud ka selle skeemifail xsd vormingus. Xml vormingus olevale failile on loodud 2 xslt faili: esimene neist transformeerib andmed html vormingusse ning tulemuseks on andmetabel, kus iga auto kohta on esitatud mark, mudel värv ja mootori andmed; teine xslt fail muudab algse xml faili vormingut ning välja antakse iga auto kohta margi ja mudeli andmed. Tehtud kodutöö vastab seega väga täpselt esitatud tingimustele.

Esitatud kodutöö kood ei ole kommenteeritud. Samuti ei ole meeskonna wiki lehel ühtegi kommentaari selle kohta, mis on antud XML alamülesande teema või eesmärk. Kuna kodutöö ülesande püstituses neid otseselt nõutud ei ole, siis ei saa seda ka puuduseks lugeda. Kood on sellegipoolest loetav ja arusaadav.

Ka dokumentatsiooni ei ole antud ülesande lahendusele lisatud, aga ka see ei olnud ka nõutud kodutöö ülesande püstituses. Samas, kui see ülesanne on loogiline osa ülejäänud kursuse kodutööde komplektist, siis juba alguses dokumentatsiooniga alustamine, oleks hea tava järgimine.

Puudustena võiks märkida, et meeskonna wiki lehel võiks siiski olla väike kokkuvõte tehtud töö sisust ja eesmärgist. Kuna kood ei ole kommenteeritud ning samuti ei ole lisatud dokumentatsiooni, siis oleks võinud meeskonna wiki lehel olla iga faili juure lause või kaks selgituseks. Kuna tehtud töö eesmärk (kui välja arvata kodutöö ära tegemise fakt) on selgusetu, siis on väga raske hinnata, kas esitatud xml fail on piisav või vajaliku struktuuriga. Ka ei saa sellistes tingimustes hinnata, kas lisatud atribuudid kolmel dimensioonil on asjakohased või mitte.

Meeskond Leemur
===XML'i retsensioon===
====XML====
XML-failis on dimensioonid
1. autod
2. auto
3. mootor, kere
4. kytus. kubatuur
Kokku seega 4 dimensiooni- nagu nõutud. Atribuute on kasutatud kolmel dimensioonil- jällegi nõuetele vastavalt. Tegijad ei ole põhjendanud, miks auto atribuut "mark" ei võiks olla auto all eraldi dimensioon. Sealt edasi mõeldes võiks auto atribuut "mudel"olla auto alaelement samal tasemel koos margiga.

====XSD====
XSD-failis on XLSi elementide puhul nõutud, et nende elemendid oleksid kindlas järjekorras kirjeldatud. See on koodi selguse ja loetavuse seisukohalt hea.
Koodi vaadates torkab silma, et auto värvidest on lubatud ainult punane, roheline ja sinine. Töö kirjeldusest ei tule välja, kas see on mingi spetsiifiline taotlus ja kui on, siis miks.

====XSL====
HTMLi kujule teisendavas koodis tundub kõik loogiline. HTMLi kujul esitatakse tabel, kus on auto mark, mudel, kere värv ja kütuseliik. Tabeli loomisel trükitakse välja nii XMLi elementide, kui ka nende atribuutide väärtusi.
XMLi formaati töötlevas XSLi failis antakse väljundisse auto mark ja mudel juhul, kui automargiks on Volvo. Ülesande nõue, XMLi töötlemine XSLi koodiga, on seega täidetud.

Kokkuvõtvalt võib öelda, et ülesande formaalsed nõuded on kõik täidetud. Meeskond võiks selgituseks kirja panna loodava rakenduse eesmärgi ja veidike kommenteerida XMLi struktuuri. Vastasel juhul jääb lihtsalt mõnest lahendusest mulje, et see ei ole päris läbi mõeldud (näiteks atribuudi asemel võiks olla eraldi element).

Meeskond TeravC

=== Veebiteenuse retsensioon - TeravC===
==== Arhitektuuriline ja tehnoloogiline ülesehitus ====
Lahendus on vastavalt kursuse nõuetele ülesse ehitatud, eraldades projektidena andmemudeli teegi, andme ligipääsu teegi ning teenuse enda teostuse. Kasutusel Code first Entity Framework andmeligipääsu kihis, ning ASP.NET Web API teenuste poole pealt.

==== Domeeni mudel ====
Andmemudel on lihtne ning selge. On, millest õppida. Meeldib mulle, et kasutusel Interface'id olemite ühtlustamiseks (IntegrityContracts). Lisaks teostatud korralik custom validator (NonNegativeDoubleAttribute).

==== Andmeligipääsu kiht ====
Andmeligipääsu kiht (DAL) teostatud nii, nagu kursusel õpetatud. Retsenseerija jaoks uudne oli lahendus, kus dependency resolver asemel kasutatakse Factory mustrit. Kasutatud EF erinevaid sättimise võimalusi optimaalse tulemuse saamiseks andmebaasi poole pealt.

==== Web API teenus ====
Ennem veebi käivitamist tuleb käivitada konsooli rakenduse, mis tekitab vajalikud andmed andmebaasi. Web API teenus töötab api/currency väljastab valuutade nimekirja. Paraku ei ole meetodit, mis kehtivad valuuta vahetuse kursid väljastaks. Ülesandes oli nõutud kasutajate audentimist, haldamist, kasutusstastikia pidamist. Valuuta vahetuse kursi kuvamine võib olla avalik teenus, seetõttu sellel nõudel suurt praktilist rakendust pole, aga miinusena mul tuleb see välja tuua :(.

Hops

2013-05-26T13:26:53Z

Atsernik: /* Andmeligipääsu kiht */

Hops

2013-05-26T13:15:28Z

Atsernik: /* Domeeni mudel */

Hops

2013-05-26T13:11:54Z

Atsernik: /* Arhitektuuriline ja tehnoloogiline ülesehitus */

Hops

2013-05-26T13:11:08Z

Atsernik: /* Arhitektuuriline ja tehnoloogiline ülesehitus */

Hops

2013-05-26T12:55:20Z

Atsernik: /* Veebiteenuse retsensioonid */

Hops

2013-05-26T12:52:06Z

Atsernik: /* Retsensioonid */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T19:36:56Z

Atsernik: /* Audentimisest */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T19:34:27Z

Atsernik: /* Audentimisest */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T19:34:01Z

Atsernik: /* Audentimisest */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T19:33:25Z

Atsernik: /* Web API lahendus 2013-05-20 */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T19:14:14Z

Atsernik: /* Pildi loomine */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T19:10:26Z

Atsernik: /* Pildi loomine */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T19:08:20Z

Atsernik: /* Pildi loomine */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T18:59:32Z

Atsernik: /* Web API lahendus 2013-05-20 */

Terav C - Võrgurakendused 2 - projektileht

2013-05-20T18:53:51Z

Atsernik: /* Ülesanne 2 - Veebiteenus */

Terav C - Võrgurakendused 2 - projektileht

2013-05-11T17:32:28Z

Atsernik: /* Tasks */

Terav C - Võrgurakendused 2 - projektileht

2013-05-11T16:46:26Z

Atsernik: /* Tasks */

Terav C - Võrgurakendused 2 - projektileht

2013-05-11T16:42:48Z

Atsernik: /* Tasks */

Terav C - Võrgurakendused 2 - projektileht

2013-05-11T16:37:52Z

Atsernik: /* Tasks */

Terav C - Võrgurakendused 2 - projektileht

2013-05-11T16:22:59Z

Atsernik: /* Tasks */