ConnectionTest-testisovellus
Yhteystestiohjelma ConnectionTest on pieni tiivis ohjelmapaketti, jolla sekä kurssilainen että ohjaaja pystyvät tarkastelemaan työssä käytetyn tietokannan tilaa ja testaamaan tietokantayhteyttä.
Sovellus osaa myös ilmoittaa alkeellisella tasolla toimiiko yhteys ja mikä meni pieleen, jos yhteys ei toimi.
ConnectionTest ei ole varsinaisesti osa tietokantasovellustasi, vaan sen tarkoitus on toimia työkaluna tietokannan kanssa säätämiseen. Joillekin suora tietokantakomentorivin käyttö voi olla nopeampaa, joskaan ohjaajasi ei tätä tapaa sinun kantaasi pysty käyttämään.
Pidä mielessä!
Ladatessasi testisovelluksen tulet ajaneeksi omilla tunnuksillasi vierasta koodia. Varmista aina että lataat koodia luotettavasti lähteestä.
ConnectionTest-ohjelma on kurssin ohjaajien ylläpitämä ja tarkoitettu täysin harmittomaksi työkaluksi. Kurssin ohjaajat eivät kuitenkaan ota mitään vastuuta siitä, että ohjelman käytön jälkeen leivänpaahtimesi syö kissasi tai mistään muistakaan ohjelman mahdollisesti tuottamista ikävyyksistä. Ohjelmaa kuitenkin pyritään kehittämään, mikäli siitä löytyy bugeja.
Toisinsanoen: Käyttö omalla vastuulla. Bugiraportteja otetaan mieluusti vastaan.
Ohjelman lähdekoodia voi tutkia myös githubissa, joskaan koodi ei ole aivan kaikista selkeintä mahdollista, johtuen yrityksistä pitää sovellus mahdollisimman tiiviinä. Ei siis välttämättä kannata ottaa testisovelluksen arkkitehtuurista oppia omaan työhön.
PHP-testisovellus
PHP:llä toimiva testisovellus on helppokäyttöisyyden nimissä mahdutettu yhteen tiedostoon ja sen voi ladata osoitteesta https://raw.github.com/AdvancedKittenry/connectionTest/master/php/connectiontest.php
Eräs tapa asentaa sovellus on kirjautua usersille ja syöttää komentoriville
cd ~/htdocs
wget https://raw.github.com/AdvancedKittenry/connectionTest/master/php/connectiontest.php
Avaa tämän jälkeen sovellus jollain ohjelmalla (esim. nano) ja korjaa sen ensimmäisillä riveillä olevat tietokantatunnukset omiksesi. Korjausta vaativissa kohdissa lukee isolla FIXME.
Java-testisovellus
Testisovelluksen Java-versio on helpointa asentaa war-pakettina.
Voit ladata paketin githubista. Paketti on valitettavasti aika iso, sillä siihen on sisällytetty kaikki tarvittavat tietokanta-ajurit. Noudata paketin ladattuasi asennusohjeita täältä.
Kun paketti on asennettu usersille sinun pitää vielä säätää XML-tiedostosta tietokannan yhteystiedot oikeiksi. Tomcat tekee tiedostosta oman kopionsa oletuksena polkuun tomcat/conf/Catalina/localhost/ConnectionTest.xml.
Avaa tämä XML-tiedosto jollain ohjelmalla (esim. nano) ja korjaa siinä olevat tietokantatunnukset omiksesi. Korjausta vaativia kohtia on kolme ja niissä lukee isolla FIXME. Tee muutoksia vain näihin kohtiin.
Jos teet projektia Users-palvelimella ja käytät Postgresql-tietokantaa, täytä kohdat seuraavasti: “username” on yliopiston käyttäjätunnuksesi, ja kohdassa “password”-kysytyn salasanan löydät Users-palvelimen kotihakemistostasi tiedostosta nimeltä .psql_password. Viimeinen kohta, url="jdbc:postgresql://localhost/FIXME_dbname" kertoo Tomcatille tietokannan sijainnin ja nimen. Users-palvelimella tietokannan nimi on aina oma käyttäjätunnuksesi.
Esimerkiksi tunnuksella kumikumi ja tietokannan salasanalla abc123 näyttää xml-tiedoston sisältö seuraavalta:
<?xml version="1.0" encoding="UTF-8"?>
<Context antiJARLocking="true" path="/ConnectionTest">
<Resource name="jdbc/tietokanta" auth="Container"
type="javax.sql.DataSource" removeAbandoned="true"
removeAbandonedTimeout="30" maxActive="100"
maxIdle="30" maxWait="10000" username="kumikumi"
password="abc123"
driverClassName="org.postgresql.Driver"
url="jdbc:postgresql://localhost/kumikumi" />
</Context>Muista käynnistää tomcat uudelleen asetusten säätämisen jälkeen.
Sovelluksen pitäisi asennuksen jälkeen pyöriä osoitteessa http://t-kayttajatunnuksesi.users.cs.helsinki.fi/ConnectionTest/
Seuraavaksi:
Kun olet saanut testisovelluksen näyttämään kannasta tietoja, on aika koodata itse ensimmäinen tietokantalistaus.