Ohjelmointitekniikka (Java) -materiaalia
© Arto Wikla.
Tämän oppimateriaalin käyttö on sallittu vain yksityishenkilöille
opiskelutarkoituksissa. Materiaalin käyttö muihin tarkoituksiin,
kuten kaupallisilla tai muilla kursseilla, on kielletty.
Ohjelmointitekniikka (Java): harjoitustehtävien julkaisuohje
(Muutettu viimeksi 15.2.2005)
Voi vieläkin muuttua!
Ohjelmointitekniikka (Java) -kurssilla keväällä 2005 opintopiirien työn
tuloksena syntyy opiskelumateriaalia www-sivujen muodossa.
Koska Java-kielen käyttö on suosittua niin ohjelmistoteollisuudessa kuin
ohjelmoinnin harrastajienkin parissa, tarkoitus on julkistaa noita sivuja
käytettäviksi yhteiseksi hyväksi, palvelemaan isänmaata ja ihmiskuntaa,
kuten yliopistolaki ylevästi sanoo.
Opiskelijoiden tuottama materiaali on kuitenkin toki tarkoitettu ennen
muuta kurssin omien opiskelijoiden käyttöön. Se on tarkoitus säilyttää
verkossa vuoden 2005 loppuun saakka.
Yliopiston ohjeet ja lainsäädäntö eivät salline opintojaksojen
osasuoritusten julkistamista ilman opiskelijan lupaa.
Siksi opintopiireillä on määräysvalta teostensa julkistamiseen.
Vaihtoehdot opintopiirin tuottaman jokaisen www-sivuston osalta
tällä kurssilla ovat seuraavat:
- Opintopiiri antaa luvan julkaista kyseisen sivuston kurssin
yleisillä internet-sivuilla.
Tämä edellyttää kaikkien tekijoiden kirjallista lupaa.
- Opintopiiri antaa luvan julkaista kyseisen sivuston laitoksen
suljetussa intranetissä, jonne pääsy on ainoastaan laitoksen
käyttöluvan omaavilla.
Myös tämä tapaus edellyttää kaikkien tekijoiden kirjallista lupaa.
- Opintopiiri luovuttaa kyseisen sivuston pelkästään kurssin henkilökunnan
arvioitavaksi.
Huom:
Vaihtoehdon valinnalla ei ole mitään vaikutusta opintopiirin harjoitustyön
arviointiin, mutta yhteisen hyvän takia toivotaan ja
suositellaan, että mahdollisimman moni sivusto saataisiin julkistaa
internetissä!
Töiden arviointi saa saman julkisuuden kuin itse työt. Julkisessa
verkossa olevat arvioidaan julkisessa verkossa, intranet-työt intrassa,
yksityiset yksityisesti. Julkisten sivujen julkisen arvioinnin peruste
on sama kuin itse sivujenkin julkisuuden: mahdollisimman laaja yhteinen hyöty.
Julkinen arviointi sisältää kuitenkin vain sisällön oikeellisuuden,
hyödyllisyyden yms. lyhyen arvioinnin. Erityisesti se ei sisällä
yksityiskohtaista kritiikkiä, tyyliarvioita, pisteitä tms.
Www-sivuston tekijöillä on luonnollisesti ja luontaisesti täydet
tekijänoikeudet sivustoihinsa niiltä osin kuin sisältö on itse
luotua.
On myös mahdollista ja luvallista eritellä sivuston osille eri tekijöitä.
Yhdellä sivustolla voi kuitenkin olla vain yksi näkyvyys
yllä luetelluista kolmesta vaihtoehdosta.
Niiltä osin kuin sivusto sisltää lainattua materiaalia, esimerkkejä,
yms., alkuperäiset tekijät ja lähteet on aina ehdottomasti mainittava!
Myös lähteinä käytettyjen www-sivujen osoitteet on annettava.
Tämä "kunnia sille kelle kunnia kuuluu -periaate koskee
kaikkia kurssin harjoitustehtäviä sivuston julkisuusasteesta riippumatta
ja on edellytys tehtäväpisteiden saamiselle.
Sivujen tekijänoikeuksia voi halutessaan hallita
Creative Commons
-lisenssointitekniikalla.
Kaikki kurssipisteitä tuottavat harjoitustehtävien ratkaisut toteutetaan
www-sivuina, jotka sähköpostitetaan ryhmän ohjaajalle ja kurssin
vastuuhenkilölle (AW).
Kaikkiin sivuihin liittyen kurssin vastuuhenkilölle
on toimitettava allekirjoitettu
paperilomake, jolla määritellään sivujen
julkisuuden aste. Tämän lomakkeen toimittaminen on yksi työn arvioinnin
edellytys!
Kaikki arvosteluun vaikuttavat tehtävien ratkaisut siis toimitetaan
ohjaajalle www-sivuina. Sivujen sisällölle asetetaan seuraavia
vaatimuksia ja toivomuksia:
- Sivujen lukijakunnaksi ajatellaan juuri Ohjelmointitekniikka (Java)
-kurssin opiskelijat.
Tämä antaa osviittaa esitystavan tasolle, auttaa arvioimaan, mitä voi lukijalta
olettaa, mitä ei.
- Ohjelmointitekniikan kurssilla on mahdotonta kuvitella, etteivät
luodut sivut sisältäisi esimerkkiohjelmia. Myös sivujen arvioinnissa
hyviä esimerkkejä arvostetaan. Ja luontevaa on myös toivoa, että
esimerkit on toimiviksi havaittu.
- Jotta sivujen laatiminen olisi hyödyllistä tekijöille, sivut
on syytä laatia sellaisiksi, että niistä on hyötyä muille. Silloin
niistä (yllätys, yllätys ;-) on hyötyä myös laatijoille itselleen!
- Teksisivuille ei useinkaan ole tarkoituksenmukaista kirjoittaa
kokonaisia Java-ohjelmia! Pelkät kiinnostavat kohdat riittävät.
Kokonaiset lähdekieliset ohjelmat on silti hyvä laittaa mukaan linkin päästä
löydettäviksi, jotta sivujen käyttäjä voi halutessaan kokeilla
ohjelmia. Seuraavassa kohdassa on teknisiä neuvoja ja esimerkkejä
sivuston laadintaan.
Harjoitusehtävien ratkaisuksi toimitettavien www-sivujen (-sivustojen)
on sisällettävä ainakin seuraavat tunnistetiedot:
- kurssi ja lukukausi
- opintopiirin nimi
- tekijöiden nimet
- sivun laadintapäivä (so. milloin valmistui)
Sivut voi laatia
mallisivupohjaan
perustuen. Myös omia formaatteja voi käyttää, kunhan kaikki tarpeellinen
tieto helposti löytyy sivulta.
Kunkin tehtävän ratkaisuun liityvät tiedostot palautetaan omana pakattuna
zip-tiedostonaan. Zip-tiedostot on nimettävä siten, että nimi
koostuu opintopiirin nimestä ja tehtävän numerosta. Esimerkiksi opintopiiri
Gurut palauttaa siis ensimmäisen kaksiviikkoisjakson lopulla kolme
tiedostoa:
Gurut-1.zip, Gurut-2.zip ja Gurut-3.zip. Tiedostot lähetetään
sähköpostitse sekä ryhmän ohjaajalle että kurssin vastuuhenkilölle (AW).
Täsmennyksiä palautusformaattiin:
- jakson tehtävät voi palauttaa joko yhtenä zip-tiedostona tai jokaisen
tehtävän omana tiedostonaan. Molemmissa vaihtoehdoissa on noudatettava
seuraavia sääntöjä:
- Zip-tiedostosta on purkauduttava index.html-tiedosto, jonka
avulla päästään kaikille muille ratkaisun/ratkaisut sisältäville
sivuille.
- Jos sivuilla käytetään jotain muuta kuin yliopiston virallista
ISO-8859-1-merkkikoodausta, zip-tiedostosta on purkauduttava myös
.htaccess-tiedosto, joka säätää merkkikoodin oikeaksi. Jos
esimerkiksi halutaan käyttää utf-8-koodia, .htaccess-tiedoston pitää
sisältää rivi:
AddCharset UTF-8 .html
- Jaksoittaiset opintopiirin itsearviolomakkeet toimitetaan erikseen.
Niitä siis ei sisällytetä tehtävien ratkaisut sisältäviin
zip-tiedostoihin!
Jos ja kun ratkaisu muodostuu useammasta html-sivusta tai sisältää
esimerkiksi erillisiä Java-lähdetiedostoja, kaikki sivujen keskinäiset
viittaukset on toteutettava suhteellisina!
Esimerkiksi tähän sivuun ei pitäisi viitata tägillä
<href="http://www.cs.helsinki.fi/u/wikla/OTJ/K05/Julkaisuohje.html">harjoitustehtävien julkaisuohje</a>
vaan esimerkiksi
<href="Julkaisuohje.html">harjoitustehtävien julkaisuohje</a>
jos viittaava sivu olisi samassa hakemistossa kuin viitattu sivu.
Viitaukset muualle on tietenkin toteutettava täydellisin linkein.
Kuten jo ylempänä mainittiin,
kaikki kurssipisteitä tuottavat harjoitustehtävien ratkaisut toteutetaan
www-sivuina, jotka sähköpostitetaan ryhmän ohjaajalle ja kurssin
vastuuhenkilölle (AW).
Kaikkiin sivuihin liittyen kurssin vastuuhenkilölle
on toimitettava allekirjoitettu
paperilomake, jolla määritellään sivujen
julkisuuden aste. Tämän lomakkeen toimittaminen on yksi työn arvioinnin
edellytys!
Takaisin kurssin pääsivulle.