Sis emadec eaciónde u o iales
in e ac i ospa aelap endizajede
lenguajesdep og amación
Ra aelCa u laTo ecilla
Ca losCongos oSando al
T abajode indeg adodelG adoenIngenie íaIn o má ica
Facul addeIn o má ica
Uni e sidadComplu ensedeMad id
Di ec o :En iqueMa ínMa ín
Codi ec o :ManuelMon eneg oMon es
2
AUTORIZACIÓN PARA LA DIFUSIÓN DEL TRABAJO FIN DE GRADO Y SU
DEPÓSITOENELREPOSITORIOINSTITUCIONALEPRINTSCOMPLUTENSE
Los abajo i man es, alumnos y u o es del T abajo Fin de G ado (TFG) en el G ado
en Ingenie ía In o má ica de la Facul ad de in o má ica, au o izan a la Uni e sidad
Complu ense de Mad id (UCM) a di undi y u iliza con ines académicos, no come ciales y
mencionando exp esamen e a su au o el T abajo Fin de G ado (TFG) cuyos da os se de allan
a con inuación. Así mismo au o izan a la Uni e sidad Complu ense de Mad id a que sea
deposi ado en acceso abie o en el eposi o io ins i ucional con el obje o de inc emen a la
di usión, uso e impac o del TFG en In e ne y ga an iza su p ese ación y acceso a la go
plazo.
TÍTULO del TFG: Sis ema de c eación de u o iales in e ac i os pa a el ap endizaje de
lenguajesdep og amación
Cu soacadémico:2015/2016
Nomb edelAlumnos:
Ra aelCa u laTo ecilla
Ca losCongos oSando al
Tu o esdelTFGydepa amen oalquepe enecen:
En iqueMa ínMa ín
ManuelMon eneg oMon es
Depa amen odeSis emasIn o má icosyCompu ación
Fi madelalumno/s Fi madel u o /es
3
4
Índice
Resumen
9
1.In oducción
11
1.1.An eceden es
11
1.2.Obje i os
12
1.3.Plande abajo
15
1.3.1.Me odologíade abajoyplani icación
16
1.3.2.Fasesdedesa ollo
16
1.4.He amien asdedesa ollou ilizadas
17
1.B.In oduc ion
19
1.1.B.Backg ound
19
1.2.B.Ta ge s
22
1.3.B.Wo kplan
23
1.3.1.B.Wo kme hodologyandplanning
23
1.3.2.B.De elopmen phases
24
1.4.BDe elopmen oolsused
25
2.Diseñodelaaplicación
27
2.1.Es uc u adeclases
27
2.2.Tecnologíasu ilizadas
29
2.2.1.Ja a[6]:
29
2.2.2.Ja aFX[7]:
29
2.2.3.YAML(YAMLAin' Ano he Ma kupLanguage):
30
2.2.4.Ma kdown:
31
2.2.5.ANTLR(Ano he ToolFo LanguageRecogni ion)[9]:
33
2.2.6.Py hon[10]:
33
5
2.2.7.JSON(Ja aSc ip Objec No a ion):
33
2.2.8.Ma en[11]:
34
2.2.9.Gi Hub:
34
2.3.De inicióndea chi osex e nos
34
2.3.1.A chi osYAML
34
2.3.2.A chi osANTLR
38
2.3.3.A chi osPy hon
39
2.3.4.A chi os empo alesJSON
41
2.4.In e accióndecomponen essiguiendoejemplodeejecución
41
2.5.In eg aciónymodi icación
42
3.Conclusiones
45
3.1.Resul adosob enidos en ea esul adosespe ados
45
3.1.1.P esen aciónde u o iales
45
3.1.2.C eaciónyadiciónde u o iales.
46
3.1.3.Sopo epa adi e en es iposdep egun a
46
3.1.4.Sopo edelenguajesin e p e ados
46
3.1.5.Funcionamien omul ipla a o ma
47
3.2.P oblemasencon adosysussoluciones
47
3.2.1.He amien aSceneBuilde
47
3.2.2.Ru asde ecu sosex e nos
48
3.2.3.Ajus edeelemen osal amañodela en ana
48
3.2.4.Mos a imagenenWebView
48
3.2.5.Compilaciónex e nadeg amá icas
49
3.B.Conclusions
51
3.1.B.Ob ained esul sbe o eexpec ed esul s
51
6
3.1.1.B.Tu o ialdisplay
51
3.1.2.B.C ea ionandaddi iono u o ials
51
3.1.3.B.Suppo odi e en kindso ques ions
52
3.1.4.B.Suppo o in e p e edlanguages
52
3.1.5.B.Mul ipla o mope a ion
52
3.2.B.P oblems oundand hei solu ions
53
3.2.1.B.SceneBuilde ool
53
3.2.2.B.Ex e nal esou cespa hs
53
3.2.3.B.Ex e nalcompila iono g amma s
54
3.2.4.B.WebViewimagedisplay
54
3.2.5.B.Ex e nalg amma compila ion
54
4.Posibilidadesdeampliación
57
4.1.Colo eadodesin axis
57
4.2.In e azg á ica
57
4.3.Ges ióndeusua ios
57
4.4Gua da es adodel u o ial
58
4.5.Cons uc o de iche osYAML
58
4.6.Ejecucióndep egun asde iposin axis
59
4.7.Lenguajescompilados
59
4.8.Mig aciónalaweb
59
4.9.Paque edeidiomas
60
5.Apo acionespe sonales
61
5.1.Ra aelCa u laTo ecilla
61
5.2.Ca losCongos oSando al
63
6.Ag adecimien os
65
7
Bibliog a ía
67
Anexos
69
A)Ac asdelas euniones
69
B)Ejemplodeusodelahe amien a
77
C)Ob enciónycompilacióndelahe amien a
83
8
Resumen
En es os úl imos años la cu iosidad po el sec o in o má ico, y más especí icamen e
en la p og amación, ha p oducido una g an demanda po los in e esados en es as á eas. Es o
ha p o ocado que el núme o de u o iales y en enado es haya aumen ado de una o ma
conside able.
Debido a es a g an demanda, ha su gido la idea de desa olla una he amien a con la
que pode ges iona u o iales de p og amación con una aplicación de esc i o io. La inalidad
de es e p oyec o es pode c ea u o iales in e ac i os que pe mi an a los alumnos adqui i
conocimien os de una o ma sencilla y a ac i a. Es o se consigue median e la posibilidad de
en iquece el o ma o del ex o al mos a las explicaciones o los enunciados de las p egun as
yañadi imágenes.
Pa a e i a que sea un u o ial de sólo lec u a, que esul a poco a ac i o y no pe mi e
al es udian e e alua los conocimien os adqui idos, con es a he amien a se pod án in e cala
p egun as en e la eo ía pa a engancha más al alumno, y consegui que el ap endizaje sea
muyinc emen al,pa ano ene unacan idadab umado adein o maciónenpoco iempo.
Con es os u o iales el alumno pod á comp oba los conocimien os adqui idos g acias
al seguimien o con inuo. El es udian e, según lea la eo ía y ealice los eje cicios con g ado
de di icul ad c ecien e, end á más capacidad pa a esol e eje cicios nue os y p epa a se
pa acon inua el u o ial.
El esul ado de es e p oyec o ha sido una he amien a mul ipla a o ma y con licencia
abie aMIT,quepuedese desca gadadeh ps://gi hub.com/Khe du/TFG
Palab as cla e: u o iales in e ac i os, lenguajes de p og amación, he amien a de
ap endizaje,YAML,Py hon,ANTLR
9
1.3.1.Me odologíade abajoyplani icación
La me odología usada en es e p oyec o ha sido Sc um [4]. Se eligió po se un mé odo
de desa ollo inc emen al, dinámico y lexible, diseñado pa a p oyec os cuyos equisi os
es án expues os a cambios, y po ello se pueden p oduci solapamien os en las dis in as e apas
de desa ollo. Además, es á pensada pa a pequeños g upos de desa ollo como es el caso de
es eequipo.
Pa a pode lle a a cabo un seguimien o y pode inc emen a la uncionalidad
paula inamen e, en p ime luga se hizo una eunión donde se habló de qué y cómo se que ía
como p oduc o inal y, cada 2 ó 3 semanas, se ue on ealizando euniones en las que se
e isaba el abajo hecho desde la eunión an e io , se ijaban unos obje i os o hi os a cumpli
den o de lo posible pa a la siguien e eunión y se analizaban posibles modi icaciones sob e
lo ya ealizado pa a mejo a la implemen ación. En pe íodo de exámenes se dejaba un
ma genmayo en e eunionesconel inde ene iempodees udia .
En cada eunión se ha omado ac a de lo a ado, es as ac as se encuen an en el
AnexoA.
1.3.2.Fasesdedesa ollo
Es as son las di e en es ases de desa ollo po las que se ha pasado, p esen adas en
o maesquemá icayconsus echasco espondien es:
1.Diseñodelos iche osquede inenlos u o iales(6/10/20153/11/2015)
● Decisióndellenguajeu ilizadopa asu ep esen ación(YAML).
● C eación de iche os de ejemplo con los campos necesa ios pa a mos a oda la
in o maciónnecesa ia.
● Inclusióndema cado esMa kdownaloscamposde ex odelos iche os.
● Gene acióndemé odosnecesa iospa ain e p e a lain o mación.
2.C eacióndelas is asdelaaplicación(3/11/201514/1/2016)
● Diseñodelas en anasdelaaplicación.
● Gene acióncódigoHTMLconlain o macióncon enidaenlos iche osYAML.
● Mues adein o maciónob enidadea chi osYAMLenlas en anas.
3.Inco po acióndelasp egun as ipo es (17/11/20151/12/2015)
● Recogidadelas espues asquees ánma cadaspo elusua io.
16
● Implemen acióndela unciónco ec o a.
● Ac ualizacióndela en anaconel esul ado.
4. Inco po ación de las p egun as cuya co ección equie e ejecución en el lenguaje des ino
(14/1/201617/03/2016)
● Decisióndeejecu a elcódigomedian ePy hon.
● C eacióndel iche odeco eccióndePy hon.
● De inición del o ma o y con enido del iche o empo al donde se gua da án los
esul adosdelaejecución.
● Implemen acióndelas uncionesco ec o asenPy hon.
● Ac ualizacióndela en anaconlain o macióndel esul ado.
5. Inco po ación de p egun as co egidas po analizado es sin ác icos (19/04/2016
27/05/2016)
● Eleccióndelanalizado sin ác icoqueseu iliza áenes e ipodep egun as.
● Gene acióndeg amá icasdep ueba.
● Gene acióndelasclasesnecesa iaspa alaco ección.
● Implemen acióndela unciónco ec o a.
● Ac ualizacióndela en anaconel esul adodeco ección.
6. C eación del a chi o de p e e encias de usua io pa a man ene la con igu ación.
(26/04/201627/05/2016)
● Búsqueda de in o mación sob e almacenamien o de a iables independien es a la
aplicación.
● Decisióndeusa a iablesdesis ema en ea iche osdecon igu ación.
● Implemen acióndemé odosdegua dadoyca gadedichas a iables.
● Enlazadoconlain e azdelaaplicaciónyp uebade uncionamien o.
Al inaliza cada ase del p oyec o se comp obaba que odo uncionase co ec amen e
y en caso necesa io, los esul ados de las ases pod ían su i modi icaciones pos e io men e
segúnlasnecesidadessegúnsea anzabaeneldesa ollo.
Los pe iodos de iempo que se encuen an en e algunas ases se han dedicado a
soluciona algunos allos que se encon aban al acaba dichas ases y ees uc u a los
elemen osdelaaplicación.
1.4.He amien asdedesa ollou ilizadas
Se han u ilizado múl iples he amien as pa a cons ui la aplicación y lo que la odea,
cada una de ellas eniendo un p opósi o especí ico y, en conjun o, han apo ado comodidad a
laho adea anza eneldesa ollodelaaplicaciónydocumen a losa ances ascadapaso.
17
La he amien a de la que más se ha dependido pa a el desa ollo de la aplicación ha
sido el en o no de desa ollo Eclipse [5] en su e sión 4.5, con di e sos plugins
pa a acili a
la esc i u a de los a chi os ex e nos YAML y la ejecución de código Py hon ( e más
3
adelan e). No en a emos mucho más en dichos plugins
, pues ienen una ele ancia meno en
elp oyec o.
O a he amien a undamen al ue Gi Hub , que u ilizamos como sis ema de con ol
4
de e sionespa aelcódigo.Es ahe amien asep esen aconmásde allesenlasección2.2.9.
Po úl imo pa a las ac as de euniones, el in e cambio de a chi os de ex o,
almacenamien o de enlaces y ci as de bibliog a ía ele an es se ha u ilizado Google Docs
ap o echandolascuen asdeusua iop o is aspo laUni e sidadComplu ense.
3Lain o maciónace cadees a ecnologíaseexplica áenelapa ado2.2.3
4Lain o maciónace cadees a ecnologíaseexplica áenelapa ado2.2.9
18
1.B.In oduc ion
The needs o p og amme s ha e been g owing exponen ially in he las ew yea s
because o he g ea inc ease o use o all kind o de ices ha needs o be p og ammed o i
he needs o socie y, specially sma phone applica ions, able s and web pages. Hence e e y
ime he e a e mo e people in e es ed in s udies ela ed o compu e science, bo h so wa e
andha dwa e.Thisb ingsus o hewo ldo elea ning.
T adi ionally, p og amming has been s udied as any o he subjec . On one side,
sel lea ning implied ge ing a language manual, and a machine wi h a ex edi o and a
compile o expe imen wi h. I , con e sely, i was o una e ha a eache could guide he
pupil, hen, he mos common ools we e he blackboa d, chalks, pen and pape , o la e go o
acompu e o es heknowledgeacqui ed.Nowadays, hesubjec isqui edi e en han hen.
E e yday new ways o lea ning p og amming languages appea . In he web we can
ind a ious ypes o u o ials and aine s o many o hese languages, abo e all (specially)
o he mos mode n and popula ones, as well as he ones ha ha e he highes p o essional
demand.Wecouldsay ha hemodelo lea ningischanginga conside ablepace.
I we look a he changes in he lea ning echniques ega ding p og amming, in he
ecen yea s i is no ed ha he e is a eedback. As lea ning me hods a e mode nized i ’s
easie o lea n, so he e is mo e people who knows and, a he same ime, hey de elop new
oolso imp o e heexis ingones.
The eam who has de eloped his applica ion as End o Deg ee p ojec wan s o
con ibu e o lea e ou ma k in his ield. Thus, he objec i e o his ool i is o c ea e an
in e ac i e p og amming language u o ial ool, which can be help ul o bo h eache s wi h
hei p og amming classes, ei he in school, highschool o college(uni e si y) as o help
sel augh people who wan o in oduce hemsel es o he wo ld o p og amming o new
languages.
1.1.B.Backg ound
The e a e plen y o ools o help lea ning p og amming languages. He e we shall
in oduce some o hem, mo e o less known, bu all o hem ele an . Al hough we su ely
lea e some in he pipeline, wi h his a p elimina y s a emen , esul o esea ch, we will gi e
ano e iewo hecu en si ua ion.
19
A ew examples o his kind o ools a e he web pages wi h aine s o he language
ha we wan o lea n. Wi h his kind o ools, in e es ed people ha e a hei disposal a ex
ield in which hey can ype li le code snippe s ela ed o he ma e explained in he u o ial
and check i i s beha iou is he one hey desi ed. Wi h hese cha ac e is ics he e a e
di e en webs. An example is he “lea n” amily webs (h p://www.lea npy hon.o g,
h p://www.lea nja aonline.o g,h p://www.lea nc.o g,h p://www.lea njs.o g,
h p://www.lea nphp.o g,h p://www.lea nshell.o g,h p://www.lea ncs.o g), which allow o
see code examples gene a ed by he u o ial and modi y hem in he code ex ield o es i
andseehow heou pu changesdependingon heinpu ield a ia ions.
Ano he simila web is www.w3schools.com, whe e I ’s o e ed he possibili y o
s udy di e en web o ien ed p og amming languages like Ja aSc ip , HTML, CSS o PHP.
This page is di ided in di e en sec ions ha allows di ec access o he one we a e in e es ed
in, hus achie ing g ea e luency when we y o ad ance o speci ic subjec s abou a
language.I alsoin eg a esa aine whe e hecodecanbemodi iedso heuse can es i .
I we wan a mo e dynamic lea ning me hod we ha e ideo u o ials, o example he
ones p esen ed in h p://uni y3d.com/es/lea n. He e demons a ions a e made h ough ideos
and b ie ex s ha explain how o de elop a p ojec om sc a ch wi h he mul ipla o m
ideo game engine Uni y[1], showing cons an ly he s eps o ollow and he changes
p oducedby hemodi ica ionsdoneinp ojec elemen s.
Nowadays i ’s being s udied he possibili y o in oduce p og amming du ing he
schola pe iod as a new class . Because o ha , games a e being de eloped whose con ols a e
simila o p og amming language sen ences. Some examples could be he web
h ps://code.o g wi h u o ials a e di ec ed owa d child en, whe e he sen ences a e al eady
w i en, and he only hing o do is o so hem by d agging hem wi h he mouse. Fo olde
child en exis s ano he web, h ps://sc a ch.mi .edu, which has a simila s yle, whe e
anima ions can be c ea ed o di e en known cha ac e s, anybody could p og am an
A duino[2]boa d.Thecommandusageissimila o hep e iousone.
Fo a public a li le bi olde , ha p e e s oleplaying and s a egy games, in
www.codecomba .com you can guide a wa io h ough di e en maps wi h Py hon code
sen ences(i ’soneo sixa aiablelanguages).
In he con ex o desk op applica ion u o ials, we ha e Swi l , a modula ool
5
designed o p esen in e ac i e o R[3] language u o ials. This applica ion i ’s execu ed
h ough a non independen in e p e e . In ha in e p e e i ’s displayed bo h he heo y
explana ion and he ques ions as plain ex . The heo y pa i ’s di ided in some subsec ions,
5h p://swi ls a s.com
20
o ad ance h ough hem i ’s needed o p ess he ENTER key. As he u o ial ad ances,
ques ionsappea ha heuse has oanswe co ec ly.
The men ioned ques ions a e es ype o code w i ing ype, he las ones a e manually
co ec ed wi h R[3] w i en unc ions, wi h he incon enience ha you ha e o in oduce hem
exac lyas hes a emen equi es obeable oad ance u he .Wecansee ha in hisimage.
In his example we can see ha in he s a emen i ’s asked o in oduce he addi ion 5
+ 7, and he use in oduces 5 + 4 + 3. The applica ion doesn’ allow o con inue unless you
in oduce heope a ionexac lyas hes a emen asks.
O he web ools used by di e en uni e si ies a e ¡Acep a el e o!
h ps://www.acep ael e o.com in he Complu ense Uni e si y o Mad id (UCM) and UVa
Online Judge h ps://u a.onlinejudge.o g in he Uni e sidad o Valladolid (UVa). These
webs, p oposes he s uden s di e en ypes o p og amming p oblems gene a ed by he own
eache s o he o ganiza ion. Tha way, he s uden s can y ou hei p og amming knowledge
and he eache scansee ha wo kanddi ec be e hei classesacco ding o ha p og ess.
A simila u iliy ee al e na i e is FLOP
h p://p oblemg.es ad.ucm.es/FLOP/index.jsp. He e he s uden s can upload hei solu ions o
21
he p oposed p oblems and check i i ’s co ec . And as eache s u ili y i exis a me hod o
gene a ese so exe cises.
A e ying ou Swi l and see how he es o he online ools wo k, we hough abou
c ea ing a desk op applica ion o e ade issues like in e ne connec ion necessi y, and he ones
de i a i es om unning ex e nal code inside an in e ne se e . Supposing some hing simila
couldbebuil ,bu mo ecomple eand iendly.Weha eanidea os a om.
This new ool should be able o sol e Swi l issues like ha ing o con igu e he
p og ameach imeweha e olaunchi and heimpossibili y oadap oo he languages.
1.2.B.Ta ge s
The main a ge o his End o Deg ee P ojec is o de elop a ee open sou ce ool o
manage p og amming languages in e ac i e u o ials, wi h he objec i e o help s uden s and
eache s ac oss any educa ional le el wi h hei di e en p og amming subjec s. I will
consis on a desk op applica ion ha allows he ealiza ion o in e ac i e u o ials wi h he
ollowing ea u es:
Sho , dynamic u o ials, a ac i e o s uden s by isual elemen s ha ease hei
lec u e.
Thepossibili y oc ea eandadd hose u o ialsindependen lyo heapplica ion
Di e en ques ion ypesuppo , i s ly es ,codeandsyn ax ype(la e explained)
In e p e ed languages suppo , ha ing Py hon in mind as a s a poin . The
6
applica ion should be able o admi any in e p e ed language wi hou he needs o any
modi ica ionin heapplica ion
Ope a i eSys emindependen usabili y.
Each language u o ials is di ided in some subjec ma e s, and hese a he same ime
a e di ided in di e en lessons. This is in ended o compa men alize in o ma ion and
s uc u e i acco ding o i s con en . Al hough u o ials wi h any ex ension could be added, i
is expec ed ha lessons a e b ie o be comple ed in a sho pe iod o ime. The lessons will
ea u e li le heo y explana ions which a e in e lea ed wi h ques ions. The la e mus be
esol ed ocomple e helesson.
6In e p e edlanguagesunde s oodas hose ha dono needacompila ionphase op oducemachinecode,bu
a eexecu edbyanin e p e e .
22
The ac ha u o ials a e independen om he applica ion will allow he eache s o
c ea e hem pe sonalized o hei s uden s by ollowing a s anda d which is de ined in his
p ojec .
Now hedi e en ypeso ques iona eexplainedmo eindep h:
Tes ype: ques ions whose ask is o make he s uden o espond by ma king one o
mo ep oposedanswe s.Ques ionscanbemul ipleanswe o singleanswe .
Code ype: ques ions which he code w i en by he s uden gene a es he expec ed
ou pu acco ding o he eache . The code will be execu ed and he ou pu will be
compa ed.
Syn ax ype: hese ques ions, unlike he o he s, check ha he code agmen
in oduced sa is y he s uc u e he eache wan s. Ano he di e ence o emphasize is
ha he code will no be execu ed in any ime, so he exi will no be checked. The
s uc u e will be de ined independen ly h ough a g amma ha will be ecognized by
hein e p e e (Insec ion2.3.2willbeexplainedhowi ’sdone).
Wi h his a ie y o ques ions, he s uden will be able o check and demons a e
e e y hing explained in he heo y he has ecen ly ead. To ad ance wi h a lesson he use is
expec ed o answe o he aised ques ion co ec ly. You can also go backwa ds o consul he
heo yo hecu en lessoni needed.
1.3.B.Wo kplan
In hissec ionwewilldiscussall heaspec s ela ed o hede elopmen o he
applica ionin a ioussec ions, hosebeing:wo kme hodologyandplanning,de elopmen
phasesandde elopmen oolsused.
1.3.1.B.Wo kme hodologyandplanning
In his p ojec he wo k me hodology used has been Sc um[4]. I was selec ed because
i is an inc emen al, dynamic and lexible me hod, designed o p ojec s whose equi emen s
a e exposed o changes and in which o e laps could happen be ween he di e en
de elopmen phases.Alsoi isdesigned o li leg oups,whichis hecaseo his eam.
To keep ack and inc ease g adually he unc ionali y, in i s ins ance a mee ing was
made whe e we alked wha and how he inal p oduc would be and, each 2 o 3 weeks,
mee ings we e made whe e i was checked he p og ess om he p e ious mee ing, new
a ge s we e locked o accomplish as a as possible o he nex mee ing and po en ial
23
modi ica ions we e analysed o imp o e implemen a ion. A exams pe iod a wide ma gin
be ween hosemee ingswe emade oha eenough ime os udy.
A eco do eachmee ingwassa ed.Thisin o ma ionisin heAnnexA.
1.3.2.B.De elopmen phases
Thesea e hedi e en s ageso de elopmen ,schema icallyp esen edandwi h hei
co espondingda es.
1.Designo he iles ha de ine he u o ials(6/10/20153/11/2015)
● Selec iono helanguage ha ep esen si (YAML).
● File c ea ion wi h examples wi h he necessa y ields o hold all he in o ma ion
needed.
● Ma kdownma ke sinclusionin he ile ex ields.
● Gene a iono heneededme hods o ead hein o ma ion.
2.C ea iono heapplica ion iews(3/11/201514/1/2016)
● Windowdesign.
● HTMLcodegene a ionwi h hein o ma ioncon ainedin heYAML iles.
● Displayin hewindowso in o ma ionob ained omYAML iles.
3.Tes ques ionsinco po a ion(17/11/20151/12/2015)
● Cap u eo hema keduse answe s.
● Co ec o unc ionimplemen a ion.
● Window e eshindica ing esul .
4. Inco po a ion o ques ions which co ec ion equi es execu ion in des ina ion language
(14/1/201617/03/2016)
● Decisiono execu ing hecode h oughPy hon.
● Py honco ec ion ilec ea ion.
● Fo ma de ini ion and con en o he empo al ile whe e he execu ion da a will be
s o ed.
● Py honco ec o unc ionsimplemen a ion
● Window e eshindica ing esul .
5.Inco po a iono ques ionsco ec edbysyn axanalyze s(19/04/201627/05/2016)
● Selec iono hesyn axanalyze obeusedin his ypeo ques ions.
● Tes g amma sgene a ion.
● Co ec ionneededclassesgene a ion.
24
● Co ec o unc ionimplemen a ion.
● Window e eshindica ing esul .
6.P e e ences ilec ea ion osa euse con igu a ion(26/04/201627/05/2016)
● In o ma ionsea chabou applica ionindependen a iabless o age.
● Decision ousesys em a iables e suscon igu a ion iles.
● Sys em a iablessa eandloadme hodsimplemen a ion.
● In e acelinkedandope a ion es .
A he end o each p ojec phase i was checked ha e e y hing ope a ed as expec ed
and, i necessa y, he esul s o p e ious phases could be la e modi ied acco ding o he
needsas hede elopmen asi ad anced.
The ime pe iods be ween some o hese phases ha e been used o sol e some
p oblems ha we e ound when hey we e inished and o es uc u e he applica ion
elemen s.
1.4.BDe elopmen oolsused
Mul iple ools ha e been used o build he applica ion and e e y hing su ounding i .
Each one o hem had a speci ic pu pose and, as a pack, hey ha e con ibu ed o ease he
de elopmen anddocumen a iondu ingand ollowingeachs epdone.
The ool which we depended he mos o he de elopmen was he in eg a ed
de elopmen en i onmen Eclipse[5] in i s e sion 4.5 wi h di e se plugins o help he
w i ing o ex e nal YAML iles and he Py hon execu ion (see ahead). No mo e in o ma ion
7
abou his will be p o ided abou hese plugins because hey ha e less ele ance in he
p ojec .
Ano he undamen al oolwasGi Hub ,whichwasusedas e sioncon olsys em o
8
hecode.
Ul ima ely, o he mee ing eco ds, ex iles exchange, link s o age and bibliog aphic
ele an ci a ions we ha e used Google Docs, aking ad an age o he accoun s p o ided by
heComplu enseUni e si y.
7In o ma ionabou his echnologyinsec ion2.2.3
8In o ma ionabou his echnologyinsec ion2.2.9
25
ez es as ex ensiones se pueden ges iona según las necesidades según el uso que se le aya a
da .Algunosejemplosdeex ensiónson:
● ALL:añade odaslasex ensiones
● TABLES:Pe mi egene a ablasHTML
● SUPPRESS_HTML_BLOCKS:Sup imelosbloquesHTML
Como ejemplo de pegdown, el código Ma kdown p esen ado an e io men e se
ans o ma íaensuco espondien eHTML:
<h1>Ni el1</h1>
<h2>Ni el2</h2>
<h3>Ni el3</h3>
<p>El<s ong>comienzo</s ong>delalis a</p>
<ul>
<li>Elp ime o</li>
<li>Elsegundo</li>
<li>El e ce o
<ol>
<li>3.1</li>
<li>3.2</li>
</ol>
</li>
</ul>
<p>Yes oel inaldelalis a</p>
< able>
< head>
< >
< h>Fi s Heade </ h>
< h>SecondHeade </ h>
< h>Thi dHeade </ h>
</ >
</ head>
< >
< d>Fi s ow</ d>
< d>Da a</ d>
< d>Ve ylongda aen y</ d>
</ >
< >
< d>Second ow</ d>
< d><s ong>Cell</s ong>
</ d>< d><em>Cell</em></ d>
</ >
</ able>
32
2.2.5.ANTLR(Ano he ToolFo LanguageRecogni ion)[9]:
Es una lib e ía que pe mi e gene a e in e p e a g amá icas independien es del
con ex o. Es o se i á pa a comp oba que el código cumple con cie os equisi os sin ác icos.
Pa a ello se esc ibe un a chi o ‘.g4’ con la g amá ica deseada y a con inuación se compila
pa a ob ene las clases Ja a (Lexe y Pa se ) enca gadas del econocimien o del pa ón
es ablecido.
La clase Lexe es la enca gada de gene a los Tokens de econocimien o a pa i de
los ca ac e es de la g amá ica de inida. La clase Pa se es la que lle a a cabo la
compa ación.
Un ejemplo sencillo de g amá ica es la que de ine la cadena “hello “ + una
cadenadesólole as.
Acon inuaciónseexplicacómode ini es ag amá ica:
g amma Hello;
:'hello'ID;
ID:[az]+;
2.2.6.Py hon[10]:
Lenguaje de p og amación dinámico y sencillo de ap ende , con una sin axis que
ayuda a hace un código legible, mul i ud de lib e ías disponibles y un ni el de abs acción
al o, lo que consigue que sen encias que en o o lenguaje son la gas se puedan ealiza en
pocas líneas de código. La e sión elegida de es e lenguaje es la 3.4, que e a la más ac ual y
es able cuando comenzó es e p oyec o. Ac ualmen e la más ecien e es la 3.5, pe o la
di e encia es pequeña y no p o oca ningún cambio sus ancial en el uncionamien o de es a
aplicación. Es e lenguaje pod ía a ia en unción del lenguaje que se aya a enseña con la
he amien a.Enes ecaso,comobaseypo suge enciadelosdi ec o es, adi igidaaPy hon.
2.2.7.JSON(Ja aSc ip Objec No a ion) :
19
Es un o ma o de ex o pensado pa a el in e cambio de da os u ‘obje os’ con un
esquema de a ibu os ipo cla e alo . Además, es un o ma o independien e del lenguaje que
lo ayaain e p e a ,y ienelib e íaspa asuusoencasi odosloslenguajes.
19h p://www.json.o g/
33
Se u iliza pa a la co ección del ipo de p egun as de ‘código’, comunicando Ja a y Py hon (o
cualquie o o lenguaje in e p e ado que se aya a u iliza ) median e un a chi o empo al de
es e ipo.
2.2.8.Ma en[11]:
Es una he amien a so wa e concebida pa a cons ui y ges iona las dependencias de
p oyec os Ja a. Con es a he amien a se acili a la impo ación y el uso de lib e ías ex e nas.
Su ca ac e ís ica undamen al es de ini la es uc u a del p oyec o con un a chi o POM
(P ojec Objec Model) , donde se encuen an las dependencias y el o den de cons ucción
20
del p oyec o. Se ha u ilizado pa a impo a y empaque a el p oyec o con las lib e ías
ex e nas.
2.2.9.Gi Hub :
21
Pla a o ma de desa ollo en pa alelo basada en el sis ema de con ol de e siones open
sou ce gi [12], que pe mi e abajo colabo a i o. Es a pla a o ma se aloja en la nube y es
muy popula en e p og amado es de odo el mundo, lo que pe mi e da g an di usión a la
aplicaciones que aloja. Se ha u ilizado debido a su acilidad de uso pa a el desa ollo en
pa alelo, pe mi iendo así a los miemb os del equipo abaja independien emen e con el
mismo eposi o io.
2.3.De inicióndea chi osex e nos
Ya se ha explicado cómo se es uc u a el di ec o io de a chi os ex e nos. En es e
apa adoexplica emoscómosones osa chi osencuan oasucon enidoyes uc u a.
2.3.1.A chi osYAML
Los a chi os donde se encuen a la in o mación de los u o iales son de ipo YAML, y
su ex ensión es ‘.yml’. Pa a que la ca ga de u o iales uncione co ec amen e es necesa io
que se man enga la es uc u a y el nomb e de las dis in as e ique as, que explica emos con un
ejemplo.
20Explicaciónenellaci a[11]delabibliog a ía
21h ps://gi hub.com/
34
P ime o amosaexplica laes uc u adel emaylasleccionesconunejemplo:
Tema:2
Ti ulo:"#Lis as"
A chi o:"py hon34/co ec o es/ ema2.py"
In oduccion:|
##Py honu iliza a ios iposdeda oscompues os,
##queseu ilizanpa aag upa o os alo es.
##Elmás e sá ileslalis a.
Lecciones:
Leccion:1
Ti ulo_Leccion:Lis as
In o_leccion:>
"Loselemen osdeunalis asedecla anen eco che esy
sepa adospo ','."
Elemen os:
Elem:
.
.
.
Es oscamposexp esanlosiguien e:
Tema:Nume odel ema(núme o)
Ti ulo:Ti ulodel ema( ex o)
A chi o:a chi odeco ecciónpa alasp egun asde ipocódigo
(lenguaje/co ec o es/ emaX.ex )dondeXeselnúme odel emayex laex ensióndel
a chi o,po ejemplopa apy honse ápy.
In oduccion: ex oconin o macióndel ema( ex o)
Lecciones:lis adelecciones( acío,elelemen oeslalis adelecciones)
Leccion:núme odelalección(núme o)
Ti ulo_Leccion: í ulodelalección( ex o)
In o_leccion:in oduccióndelalección( ex o)
Elemen os:lis adeelemen osdelalecciónlis adeelemen os( acío)
Elem:haydos iposdeelemen o,seesc ibi ácuales(p egun aoexplicacion)
Hayquedes aca queun emapuede ene odaslasleccionesqueseannecesa iasy
unalección ambiénpuede ene odosloselemen osquesequie a.
Aho aexplica emosquécon ieneunelemen oycómosees uc u a,comenzamoscon
lasexplicaciones:
Elem:explicacion
Con enido:>
35
Loselemen osdeunalis ano ienenpo quése odosdel
mismo ipo.Enlamismalis apuedehabe núme osen e osy
cadenas.
.
.
.
Las explicaciones sólo ienen un campo, en el que end emos ex o con la p opia
explicación,imágenesyloselemen osma kdown ep esen ados.
Con enido: ex o donde esc ibi emos la explicación. Se comienza con ‘>’, que es una
e ique a que indica que el siguien e ex o igno a á los sal os de línea, alineando así el ex o.
En caso de pone bloques de código se puede esc ibi con ‘|’, que conse a á dichos sal os de
línea alycomoes énenela chi o.
Aho a e emoslasp egun asde ipoopciones:
Elem:p egun a
Nume o:2
Enunciado:>
¿queopciónesco ec apa aex ae
losdosnomb esdelalis al=["Ra ael","Ca los",32,27]?
Tipo:Opciones
Pis a:Lanume acióndeloselemen oscomienzaen0
Mul iple:yes
Opcion_co ec a:1,2,3
Opciones:
1)l[0:2]
2)l[:2]
3)l[0:2]
4)l[1:3]
.
.
.
Enunciado:elenunciadodelap egun a(comúna odaslasp egun as)
Tipo:Opciones,aquíseindica á(comúna odaslasp egun as)
Pis a: campo opcional con una pis a que pueda ayuda a esol e la p egun a (común a odas
lasp egun as)
Mul iple: (solo pa a es ) yes | no Indica si la p egun a iene una o más soluciones, es en
ingléspo quealin e p e a elá bol aducedi ec amen ees enodoabooleano
36
Opcion_co ec a: (solo pa a es ) núme o o núme os (en caso de ene más de una opción
co ec a) de la opción co ec a. Siemp e hay que pone los alo es en e comillas. Ej: "1" ó
"1,2,3".
Opciones: (solo pa a es ) lis a en la que se enume an las opciones. El núme o de opciones
puede a ia .
Vamosaho aconlasde ipocódigo:
Elem:p egun a
Nume o:1
Enunciado:C eaunalis a'l'condosnomb esylosnúme os32y
27
Tipo:Codigo
Resul ado:p egun a11
.
.
.
Resul ado: en el único campo especí ico de es as p egun as se esc ibi á el nomb e de la
unciónquecomp oba áelcódigo.Es a unciónes a áimplemen adaenela chi oco ec o .
Ypo úl imolasdesin axis:
Elem:p egun a
Nume o:3
Enunciado:>
Esc ibeelcódigopa ain oduci enlalis a'l'
losnume osdel1al5u ilizandounbucle
Pis a:Consul ael emadebuclessi ienesp oblemas
Tipo:Sin axis
G ama ica:CadRep
Resul ado:l=[1,2,3,4,5]
Ysuscamposson:
G amá ica:nomb edela chi oco espondien ealag amá icaalaque engaqueajus a sela
espues a.
Resul ado:(opcional)Sique emos ene comp obacióndel esul ado.Aunquees aopción,
comoexplica emosmásadelan enosecomple ó,nospa ecióin e esan eman ene es e
campo.
En los campos de ex o del iche o YAML se pueden pone e ique as ipo Ma kdown
pa a in oduci imágenes, que es a án en el di ec o io img de la ca pe a del lenguaje del
37
u o ial en cues ión, así como esal a pa es del ex o o in oduci agmen os de código y que
sean mos ados con una uen e dis in a al ex o no mal. Es o acili a á la lec u a del alumno y
leayuda áaman ene laa enciónalaspa esmás undamen ales.
Enelcasodeque e in oduci imágenesconMa kdown,la u aqueseespeci iqueen
lae ique a ienequese la ela i aaldi ec o ioex e nalResou ces.
O o da o undamen al pa a esc ibi es os a chi os es que hay que espe a las
abulaciones y espacios pa a anida co ec amen e los elemen os, o se p oduci á un e o al
a a de in e p e a el a chi o. Igualmen e ocu e si no se espe an los acen os de las
e ique as. Hay que esc ibi las al y como se p esen an. Pa a más in o mación ecomendamos
e losejemplosdel eposi o ioGi Hubdelp oyec o.
2.3.2.A chi osANTLR
Es osa chi ossonlosquecon ienenlag amá icade inidapo elp o eso .Enelcaso
dees ep oyec osehau ilizadola e sión4.XdeANTLR,po loquelaex ensióndelos
a chi oses‘.g4’.En e sionesan e io esse ía‘.g’.
Pa aque uncioneco ec amen econANTLRyconnues aaplicaciónela chi oha
decumpli unase iede equisi os:
● El nomb e del a chi o debe coincidi con el de la g amá ica (mayúsculas y
minúsculas ambién)
● Elnomb edela egladebecoincidi coneldelag amá ica( odoenminúsculas)
Unejemplodeg amá icase íaelsiguien e:
Elcon enidodela chi oT iangulo.g4es:
g amma T iangulo;
iangulo:'h='NUMBER' nb='NUMBER' n'FORMULA;
NUMBER:[09]+;
FORMULA:'a=h*b/2';
Enes ea chi osedesc ibeunag amá icaqueespe a ecibi un agmen odecódigo
necesa iopa ahalla elá ea‘a’deun iánguloconasignaciónde alo esados a iables:
h:al u a
b:base
Conelejemploan e io ,el agmen odecódigoacep adose ía:
h=2
b=3
38
a=h*b/2
Po elcon a iounael agmen odecódigoinco ec ose ía:
h=hola→Fallapo queseespe aqueala a iablehseleasigneunnúme o
b=3
a=3 →Fallapo queespe ala ó muladelá eadel iángulo
2.3.3.A chi osPy hon
Los a chi os Py hon con end án las unciones co ec o as de las p egun as de ipo
código. Se c ea á un a chi o ‘.py’ po cada ema que enga el u o ial. Cada uno de es os
a chi os ieneunaes uc u asimila alaque amosap esen a conunejemplo:
P ime o amos a e los impo necesa ios en dicho a chi o. Po de ec o se usan
undamen almen e es pa a la co ección pe o, como es e iden e, se pod á añadi cualquie
o a lib e ía necesa ia pa a la co ección de p egun as, siemp e y cuando el in é p e e la enga
disponible.Es aslib e íasson:
sys: Es a lib e ía nos pe mi e ob ene las a iables que nos llegan desde Ja a y acaba
laejecución.
json:Nospe mi e a a ela chi ojson.
emp ile:Nospe mi eope a conela chi o empo al.
Aho a amosa e unejemplodelcódigoPy honco espondien eal iche ode
co ecciónindicadoenelYAMLmos adoan e io men e:
de p egun a11(code, ilename):
y:
exec(codigo)
dicc={}
=["Ra a","Ca los",32,27]
i se (locals()['l'])==se ( ):
alue1=T ue
alue2=''
alue3=['']
else:
alue1=False
alue2='E o decon enido'
alue3=['Puedequehayasesc i omalloselemen os']
dicc['isCo ec ']= alue1
dicc[' ypeE o ']= alue2
39
dicc['hin s']= alue3
wi hopen( ilename,'w')asou ile:
json.dump(dicc,ou ile)
sys.exi (0);
excep Excep ionase:
e.p in _exc()
sys.exi (1)
de main():
ques ion=sys.a g [1]#1
code=sys.a g [2]#2
emp_name=nex ( emp ile._ge _candida e_names())
de aul _ mp_di = emp ile._ge _de aul _ empdi ()
ilename=de aul _ mp_di +'/'+sys.a g [3]
i ques ion=="p egun a11":
p egun a11(code, ilename)
i __name__=="__main__":
main()
Segu amen e hab á muchas más o mas de cons ui es os a chi os que uncionen
co ec amen e. Es a es la que se u iliza en los u o iales de ejemplo que se han c eado.
Vamosapasa aexplica quéhace:
Comencemos po el mé odo main. Aquí sacamos los a gumen os que la aplicación
Ja a le pasa al in é p e e de py hon, es os a gumen os los sacamos del a ay sys.a g []. El
a gumen o 1 es el nomb e de la p egun a a co egi , el 2 es el código que enemos que p oba
y el núme o 3 el nomb e del a chi o empo al donde enemos que esc ibi el esul ado pa a
que Ja a sepa lo que ha ocu ido en la ejecución. En el siguien e apa ado explica emos qué
hayenes ea chi o.
Lo p ime o que hacemos es p epa a el nomb e del a chi o empo al. Ob enemos la
u a has a el di ec o io de a chi os empo ales y le conca enamos el nomb e. Después
comp obamos que el nomb e de la p egun a que nos han pasado es alguno de los que enemos
en es e a chi o. En caso de que haya a ias p egun as se pond án odas las opciones con un
bloquei else.
Aho a pasamos a la p egun a en cues ión. A es as unciones co ec o as se les pasa á
como a gumen os el código que end emos que comp oba y el a chi o donde enemos que
esc ibi la solución. Pa a asegu a nos de que el código es ejecu able usamos un bloque
yca ch.
La unción que ejecu a el código es exec(). Una ez ejecu ado end emos que
busca que las a iables pedidas en la p egun a es én c eadas y con sus alo es
40
co espondien es disponibles. Es én o no end emos que ellena el esul ado. Pa a eso es án
lossiguien escampos:
● alue1:El esul adodelap egun a,siendoés e ue
o alse
● alue2:Tipodee o .Es ese áelmensajequesemos a áencasode alla
● alue3: Lis a de pis as adicionales. Es as pis as a ían en unción del e o que
come aelalumno,siendosólo isiblescuandoelalumno alle.
Una ez c eadas es as a iables las in oducimos en un dicciona io cla e alo
en con
los campos co espondien es a es as 3 a iables, nomb ados ‘isCo ec ’, ‘ ypeE o ’ y ‘Hin s’,
pa aluego olca losenela chi o empo al.
Cabe menciona que la o ma de inaliza es e código ep esen a el es ado en el que
acaba la ejecución. Es o iene una in e p e ación en Ja a. Si el p oceso acaba con ‘0’ es que
se ha ejecu ado co ec amen e. Sin emba go si acaba con ‘1’ se in e p e a á que ha habido un
allodeejecución,posiblemen epo sin axis.
2.3.4.A chi os empo alesJSON
Los a chi os JSON se án el mé odo de comunicación en e Ja a y Py hon. Decidimos
u iliza a chi os empo ales pa a que no quede basu a una ez acabada la ejecución de los
u o iales.Es osa chi os ienenunaes uc u amuybásica,que e emosacon inuación:
{'isCo ec ':T ue,' ypeE o ':'co ec o','hin s':['p ueba1','p ueba2']}
Es o ep esen a el dicciona io que c eamos en el a chi o Py hon, y se á in e p e ado
po Ja apa amos a el esul adoalusua io.
2.4. In e acción de componen es siguiendo ejemplo
deejecución
Pa a explica cómo se enlazan odos los componen es y se u ilizan las lib e ías
e emos un ejemplo paso a paso. Toma emos como pun o de pa ida el a chi o YAML de la
sección2.3.1que ep esen aun emamodelo.
Cuando a anca la aplicación, la clase con olado busca u ilizando la Ja a
P e e ences API , en a iables de en o no en o no del sis ema ope a i o, la u a del
22
22h p://docs.o acle.com/ja ase/7/docs/ echno es/guides/p e e ences/
41
3.2.2.Ru asde ecu sosex e nos
La ges ión de acceso a di ec o ios ex e nos a la aplicación supuso un queb ade o de
cabeza pa a los desa ollado es. A pesa de sabe que e a necesa io lidia con es o desde una
ase emp ana del desa ollo, se comenzó haciendo que los a chi os ex e nos es u iesen
in eg ados al empaque a la aplicación, lo que, aunque acili aba eno memen e la ges ión de
u as, p o ocaba que cada ez que se quisie a in eg a nue os u o iales a la aplicación
hubieseque ecompila y eempaque a odoelp oyec o.
Solución omada:
Como al e na i a a es e p oblema se ha decidido u iliza P e e ences API de Ja a, que
nos pe mi e almacena la u a del di ec o io ex e no de inido an e io men e. Es o ambién
p o ocó un lige o e aso debido a que se u o que busca in o mación ace ca de es a
ecnología.
3.2.3.Ajus edeelemen osal amañodela en ana
Una ez c eada la in e az g á ica de la aplicación, se descub ió que los elemen os que
o maban pa e de la is a no se ajus aban al amaño de la en ana en el caso que se
edimensionase. Es o se debía a que no se es aba u ilizando el ipo de panel adecuado y
ademásenelmomen odemos a loselemen ossehacíade o mae ónea.
Solución omada:
Busca in o mación ace ca de los paneles disponibles en Ja aFX y selecciona el que
se ajus aba a las necesidades. Con es a solución se e eló el p oblema que había en el código
con espec o a cómo se mos aban los elemen os, que ambién ue esuel o aunque se u o
quededica más iempodelespe ado.
3.2.4.Mos a imagenenWebView
O o p oblema elacionado con las u as de los ecu sos ex e nos ue consegui
mos a las imágenes ligadas al código HTML. Es o es aba causado po que pa a mos a
imágenes median e HTML hacía al a especi ica la u a absolu a al ecu so. Es e p oblema
ue acompañándonos a lo la go de la mayo pa e del p oyec o debido a que no
encon ábamosla azóndelp oblema.
48
Solución omada:
La solución a es e p oblema ue in es iga du an e mucho iempo la posible azón y e
i p obando con las dis in as soluciones que íbamos encon ando. Pa a e i a e asos en la
en ega del p oyec o, se decidió con inua con la aplicación y abaja en la solución en
pa alelo.
3.2.5.Compilaciónex e nadeg amá icas
Pa a las p egun as de sin axis son necesa ias las clases c eadas po ANTLR. Pa a es e
apa ado en un p incipio se decidió ene como ex e no solamen e el a chi o donde se esc ibe
la g amá ica, lo que suponía ene que cons ui las clases con ANTLR en cada ejecución y
además hace una compilación en iempo de ejecución. Es o suponía un p oblema po la
necesidad de ene JDK en ez de JRE ins alado en la máquina donde se uese a usa la
25 26
aplicación,po ene queu iliza lib e íasdecompilación,nodisponiblesenJRE.
Solución omada:
C ea eneldi ec o iode ecu sosex e nosundi ec o ioconlasclasesdeANTLR
compiladasp e iamen e.Es op opicióel ene quebusca in o maciónace cadecómohace
usodees asclasesde o maex e naalaaplicación.
25JDK(Ja aDe elopmen Ki )eselki dedesa ollodeJa a,queincluyelashe amien asdecompilación,
cons uccióndep oyec osyelp opioJRE
26JRE(Ja aRun imeEn i onmen )eslap opiamáquina i ualdeJa a,quepe mi elaejecuciónde
aplicacionesja a
49
50
3.B.Conclusions
In his sec ion we will discuss he esul s ob ained agains he expec ed esul s, he
p oblems ound o each he objec i es and he solu ions aken o sol e hem. Besides, we
will sugges possible ex ensions ha could be b ough o imp o e he applica ion. Some o
hem we e no made because he limi ed ime a ailable o a p ojec o his scope. The las
sec ion consis s o ideas ha in ol e big changes, in ended o be implemen ed in he long
e m.
3.1.B.Ob ained esul sbe o eexpec ed esul s
In his sec ion, we a e going o concen a e on checking i he ma ked objec i es om
s a we eachie edinasa is yingwayo no .
Thenwewill alkabou heob ained esul sagains eachobjec i e:
3.1.1.B.Tu o ialdisplay
This objec i e has been achie ed, because he main objec i e has been comple ed, he
p esen a ion o sho u o ials, ob aining he expec ed dynamic in e ac ion, hanks o he
possibili y o al e na e di e en kind o ques ions in which he s uden can check in a quick
way heacqui edknowledge.
Because o he limi ed ime and some issues o show ce ain isual elemen s, he
use ’s in e ace has no been made mo e appealing, because we ad anced in a o o he
ool’s unc ionali y.
3.1.2.B.C ea ionandaddi iono u o ials
F om he beginning we conside ed he possibili y o handle u o ials o be displayed
wi h his ool. In i s ins ance, o be able o use hese u o ials, hey had o be esou ces o he
ool implemen a ion. This ac implied ha each ime someone wan ed o add, dele e o
modi y any o hese elemen s, i had o ecompile and package he en i e p ojec . This ask
wouldbe edious o he eache .
51
To ease his, i was allowed ha bo h YAML iles and he necessa y esou ces o he
u o ial we e placed inside an ex e nal di ec o y o he applica ion. This way, eache s would
jus ha e oc ea eo modi y he u o ialsanddis ibu e hembe ween hes uden s.
3.1.3.B.Suppo odi e en kindso ques ions
The applica ion o e s di e en kind o ques ions which s uden s who wan o
comple e hese u o ialsmus answe co ec ly.
As i has been men ioned be o e, he di e en ypes o ques ions o e ed a e: code,
es and syn ax. The objec i es a e achie ed wi h he i s wo ypes. Rega ding he las one, i
was in ended in i s ins ance o check he ou pu . Bu because o limi ed ime and di e en
issues ha appea edbe o e hisphase,i ’sjus checked he o ma o heinpu code.
3.1.4.B.Suppo o in e p e edlanguages
The ool was designed o wo k wi h in e p e ed p og amming languages. This is
because o he ease o execu e he sen ences w i en by he use . The po en ial ouble is
ound in he code ype ques ions because hese a e he ones in which checking is made
h ough heexecu iono hecode ha wasin oducedby hes uden .
To achie e his objec i e, checking is made om he selec ed language in e p e e
ins alled in he use ’s sys em. This way he execu ion is applica ion independen so i doesn’
ma e whichlanguagewea ewo kingwi h.
3.1.5.B.Mul ipla o mope a ion
Since de elopmen s a ed, we expec ed he applica ion o be dedica ed o he
s uden s. Because he ac ha people ha e di e en p e e ences alking abou Ope a ing
Sys ems which a e chosen because o need o p e e ence, ha implied he OS sys em
27
independen ope a ion. Thanks o he ac o building he applica ion wi h Ja a, his a ge has
beencomple ed.
Howe e , in OS and Linux
, he in e ace can show li le isual de ec s, o example
no showingp ope lysomeelemen s.
27Fu he OS
52
3.2.B.P oblems oundand hei solu ions
O e de elopmen , some issues ha e appea ed ha ha e obs uc ed he p og ess o
he p ojec o a g ea e o lesse ex en . Ne e heless i has no made he e mina ion o he
p ojec impossible,bu i hasimpliedsomedelaydu ingeacho hede elopmen phases.
Nex wewillexplainsomeo hemos ele an issues.
3.2.1.B.SceneBuilde ool
When he in e ace de elopmen s a ed, using Ja aFX we ied o build he design o
he iews wi h he ex e nal ool SceneBuilde . This ool was designed o gene a e
g aphic in e aces wi h Ja aFX. I gene a es an FXML ile wi h he elemen s om which he
in e ace is composed . This ile o ma is ba ely unde s andable . This in oduced lo s o
ex adi icul ies oimplemen i s unc ionali yand omodi y hembyhand.
Solu ion aken:
Sea ch o in o ma ion o build hese iews by means o code, and o implemen hem
in ha way.
3.2.2.B.Ex e nal esou cespa hs
The managemen o applica ion ex e nal di ec o ies was a headache o he
de elope s. Despi e knowing i was a key ea u e o deal wi h since an ea ly de elopmen
phase, ini ially ex e nal iles we e packaged oge he wi h he applica ion, which, e en
hough easen pa h managemen , i led o ecompiling and epacking he en i e p ojec each
imewewan ed oincludenew u o ials o heapplica ion.
Solu ion aken:
As an al e na i e o his issue we decided o use he Ja a P e e ences API, which
allows us o s o e he pa h o he ex e nal di ec o y de ined be o e. This ac also in ol ed a
li ledelaybecauseo hein o ma ionsea ch his echnology equi ed oimplemen i .
53
3.2.3.B.Ex e nalcompila iono g amma s
Once he applica ion’s g aphic in e ace was c ea ed, we ound ou ha he elemen s
ha composed i didn’ adjus a all o he windows shapes i i was esized. Tha was caused
because o he kind o panels chosen was no app op ia e and i did no display co ec ly he
elemen sin hes age.
Solu ion aken:
Resea ch o u he in o ma ion abou Ja aFX a ailable panels and choose one
acco ding o he needs o each case. Wi h his solu ion i appea ed ano he issue ega ding he
elemen display.I wasalsosol edbu i ookmo e ime hanexpec ed.
3.2.4.B.WebViewimagedisplay
Ano he issue ela ed o he pa hing o ex e nal esou ces was o display co ec ly he
images linked o he HTML code. This was caused due o he need o speci y he absolu e
pa h o he esou ce. This issue was p esen h oughou mos o he de elopmen phase
becausewedidno indou hesou ce.
Solu ion aken:
We sol e his by in es iga ing o a long ime he possible causes and ying ou all
he di e en possible solu ions we ound. To a oid mo e delays on he p ojec deadline, we
decided ogoonwi hall hede elopmen andwo kin hesolu iona hesame ime.
3.2.5.B.Ex e nalg amma compila ion
Fo he syn ax ques ions, classes c ea ed by ANTLR a e needed. Fo his sec ion he
i s idea was o ha e as ex e nal ile he one whe e he g amma was de ined, which implied
o build he ANTLR classes each ime we needed o execu e he in ol ing ques ions, and also
o make an execu ion ime compila ion. The las one implying he needs o ha e JDK
28
ins ead o JRE ins alled in he hos machine, because compila ion lib a ies we e needed, no
29
includedin heJREdis ibu ion.
28JDK(Ja ade elopmen Ki )i includescompila ionandp ojec building oolsandalsoJRE
29JRE(Ja aRun imeEn i onmen )is heJa aVi ualMachinei sel ,whop o ideJa aapplica ionexecu ion.
54
Solu ion aken:
C ea ing he ex e nal esou ce di ec o y wi h he ANTLR classes p e iously
compiled. This in ol ed sea ching he in o ma ion abou how o make usage o hese classes
ex e nally o heapplica ion.
55
56
4.Posibilidadesdeampliación
Dado el po encial de aplicación de es e p oyec o en el ámbi o académico cabe pensa
en cómo se puede mejo a y amplia en un u u o pa a da le más u ilidades y comodidades
pa alosusua ios.
Acon inuaciónsedesc ibenideaspa apode amplia es aaplicación:
4.1.Colo eadodesin axis
En el campo de ex o des inado a esc ibi el agmen o de código se mues a el ex o
plano al y como lo esc ibe el usua io. Una posible modi icación muy a ac i a de ca a al
usua io se ía añadi un colo eado a la sin axis esal ando las palab as ese adas del lenguaje
en cues ión. De es a mane a, el componen e de in oducción de código end ía un
compo amien osimila aunedi o de ex oen iquecidoounen o nodedesa ollo.
Añadi es a uncionalidad supone ene que lidia con la in e az de Ja aFX en la que
se ep esen a el código, haciendo que as cada pulsación de ecla se e ise el ex o que enga
esc i oysecomp uebesi ienepalab as ese adaspa acambia leselcolo .
4.2.In e azg á ica
El desa ollo de es a aplicación se ha cen ado más en la uncionalidad de la
he amien a. Po eso, los elemen os de la in e az apa ecen de una o ma sencilla y esul an
pocoa ac i osdeca aalosusua ios.
Una cla a mejo a se ía o o ga animaciones a los elemen os como pueden se los
bo ones o busca una combinación de colo es y una dis ibución más a ac i a de ca a a los
p incipalesusua ios,losalumnos.
4.3.Ges ióndeusua ios
Debido a que es una he amien a que puede se usada an o po p o eso es pa a c ea
u o iales, como po di e en es alumnos pa a ap ende sob e un lenguaje de p og amación, en
un u u o se pod ía añadi un ges o de usua ios que mues e dis in os ipos de in e aces y
57
mí debido a que yo conocía mejo los elemen os de cada en ana y pod íamos a anza de una
o ma más ápida. La pa e enca gada de lle a a cabo la co ección de dichas p egun as ue
ealizada jun o a mi compañe o debido a su mayo conocimien o sob e Py hon. Busqué
in o mación sob e dicho lenguaje y me hice ca go de esc ibi un pequeño esquele o del
a chi o que con iene las unciones co ec o as a cada p egun a del ema. Más a de le
expliqué la idea de ejecución que se lle a a cabo pa a que pudie a a anza con el abajo
mien as yo me cen aba en a egla pequeños allos de ases an e io es y a anza con los
elemen os isuales.
Pa a las p egun as de ipo sin axis, debido a que mi compañe o es aba enca gado del
desa ollo de o os elemen os del p oyec o, busqué in o mación ace ca de la he amien a
necesa ia pa a gene a las g amá icas. Una ez u e una idea gene al de cómo se podían hace
g amá icas pe sonalizadas empecé a hace pequeñas p uebas y cuando comp obé que
uncionaban co ec amen e, empecé a esc ibi las necesa ias pa a es e u o ial conc e o, así
comosucompilaciónysu uncionamien odesdeden odeunaaplicaciónJa a.
En nues o p oyec o se p opuso la idea de que las clases que ealizan la comp obación
median e sin axis ue an independien es a la aplicación. Po lo an o, pa a hace uso de ellas,
había que gene a las clases ue a del p oyec o y hace la llamada ex e na desde el mismo.
Po eso, consul é con los di ec o es pa a que me guia an cómo hace lo, y empecé a p oba
has aconsegui eléxi odees ecome ido.
Como enca gado de la pa e isual, me i en la necesidad ene que hace una
ac ualización de la en ana as con es a a las dis in as p egun as, así que añadí un elemen o
más a los paneles, que mues an las p egun as pa a indica si la espues a in oducida po el
usua ioencualquie adelos o ma osesco ec aono.
64
6.Ag adecimien os
Que emos da las g acias a los di ec o es En ique y Manuel, po es a ahí cuando
hacía al aunempujónpa acon inua conelp oyec o.
También que emos da las g acias a la Asociación Socio Cul u al de Ingenie os en
In o má ica (ASCII) po es a siemp e ahí pa a anima nos en nues os momen os de bajón e
inci a nos a cambia el abajo po unos a os de juego y di e sión, y da nos consejos
b illan esconalgunos oci osdecódigo,enespecialaMikyyPon .
No nos ol idamos de nues as amilias, que siemp e han es ado p esen es en las ganas
que le hemos echado al desa ollo en las innume ables ho as de dedicación, y que nos han
sopo adoyapoyadodu an e an osañosdeca e a.
Tenemos que menciona ambién a la web h p://s acko e low.com/ y su comunidad,
po ayuda nos en nume osas ocasiones apo ando ideas y ejemplos de código que nos han
ayudadoaacaba elp oyec o.
Po úl imo que emos menciona a Will, po echa nos una manilla con la aducción, y
a í ulope sonalalgunosag adecimien osmás.
65
66
Bibliog a ía
[1]La ie i,D Edwa d.Ge ingS a edwi hUni y5
.Pack ,2015.
[2]Ma golis,Michael.A duinoCookbook
.Sebas opol,CA:O'Reilly,2012.
[3]C awley,MichaelJ.TheRBook
.Chiches e ,England:Wiley,2007.
[4]Su he land,Je eyVic o .Sc um:TheA o DoingTwice heWo kinHal heTime
.
[5]Vogel,La s.EclipseIDE:Ja aP og amming,Debugging,Uni Tes ing,Task
Managemen andGi Ve sionCon olwi hEclipse
.Leipzig:Vogella,2013.
[6]Eckel,B uce.ThinkinginJa a
.Uppe SaddleRi e ,NY:P en iceHall,2014.
[7]Ho s mann,CayS.Ja aSE8 o heReallyImpa ien
,2014.
[8]Meye ,E icA.,andE icA.Meye .CSS:TheDe ini i eGuide
.Beijing:O'Reilly,2007.
[9]Pa ,Te ence.TheDe ini i eANTLR4Re e ence
,2013.
[10]Lu z,Ma k.Py hon
.Camb idge:Ed.O'Reilly,2010.
[11]Ma en
.S.l.:Alphasc ip ,2012.
[12]Loelige ,Jon.Ve sionCon olwi hGi :
.Beijing:O'Reilly,2009.
67
68
Anexos
A)Ac asdelas euniones
NºDEACTA:1
FECHA:06Oc ub e2015
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
ORDENDELDÍA:
Decisionessob e ecnologíasau iliza
DECISIONESTOMADAS:
Lenguajedep og amación:Ja a
Tipodea chi ode u o iales:YAML
Lenguajedi igidoel u o ial:Py hon3.4
OBJETIVOSACUMPLIRPARALAPRÓXIMAREUNIÓN
C ea losa chi osYAML
NºDEACTA:2
FECHA:20Oc ub e2015
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
ORDENDELDÍA:
Comp oba a chi osYAML
69
DECISIONESTOMADAS:
Cambia aspec osdelYAML
Añadi campopis apa aalgunasp egun as
Añadi e ique asMa kdownaloscamposde ex o
UsodeSNAKEYAMLcomoin é p e edelosa chi osYAML
OBJETIVOSACUMPLIRPARALAPRÓXIMAREUNIÓN
Lle a acabolasmodi icacionesp opues as
Elegi ecnologíapa ain e p e a Ma kdown
NºDEACTA:3
FECHA:03No iemb e2015
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
ORDENDELDÍA:
Comunica alosp o eso es ecnologíaselegidas
Comp oba queloscambios ienenéxi o
Comp oba es uc u adeclasesJa a
DECISIONESTOMADAS:
Seacep aelusodeMAVENpa alasdependenciasdelib e íasex e nas
OBJETIVOSACUMPLIRPARALAPRÓXIMAREUNIÓN
Comp oba lain e p e acióndelase ique asMa kdown
Mos a in o maciónpo en ana
70
NºDEACTA:4
FECHA:17No iemb e2015
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
ORDENDELDÍA:
P oba elemen oswebenlas is as
OBJETIVOSACUMPLIRPARALAPRÓXIMAREUNIÓN
Cambia pa hde ecu sos
P oba elemen oscomplejosconpegdown
P o o ipodep egun as ipo es
NºDEACTA:5
FECHA:01Diciemb e2015
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
ORDENDELDÍA:
Comp oba losobje i osdela euniónan e io
DECISIONESTOMADAS:
Segui conlosp oblemasplan eados
OBJETIVOSACUMPLIRPARALAPRÓXIMAREUNIÓN
Inclui hojasdees ilo(CSS)enlas is as
Cambia o ma odeopcionespa ap egun asdeopciones(checkboxo adioBu on)
lujode en anasenpapel
71
NºDEACTA:6
FECHA:17Diciemb e2015
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
ORDENDELDÍA:
Comp oba a ances
Deba i eldiseñode lujoen e en anas
DECISIONESTOMADAS:
Cambia el lujode en anaspa apode mos a p egun asin e caladasconla eo ía
OBJETIVOSACUMPLIRPARALAPRÓXIMAREUNIÓN
Cons ui en anaúnicapa ala eo íaylasp egun as
Mos a el lujodeunalecciónconp egun asde ipo es
NºDEACTA:7
FECHA:14Ene o2016
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
ORDENDELDÍA:
Comp oba el lujodelalección
DECISIONESTOMADAS:
El lujoesco ec o
Con inua conelp oyec o
OBJETIVOSACUMPLIRPARALAPRÓXIMAREUNIÓN
Ejecucióndep egun as ipocódigo
72
Gene a iche opy honco ec o
P oba enlinux
Modi ica elYAMLpa aañadi elcampoconelnomb edel iche oco ec o
NºDEACTA:8
FECHA:18Feb e o2016
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
ORDENDELDÍA:
Comp oba a ancesdelp oyec o
Deba i cómoejecu a Py hon
DECISIONESTOMADAS:
Ejecu a Py hona a ésdelin é p e e
EjecucióndePy honconunhiloindependien epa aquenohaya iesgodequela
aplicaciónsecuelgue
Usode uncionesdegene ación/lec u adesalida
OBJETIVOSACUMPLIRPARALAPRÓXIMAREUNIÓN
Lle a acabolaejecucióndePy honcon odaslasins uccionesdecididas
NºDEACTA:9
FECHA:08Ma zo2016
ASISTENTES:
Ra aelCa u la
Ca losCongos o
En iqueMa ín
ManuelMon eneg o
73
Una ezseleccionadoel ema,sellegaalmenúdelaslecciones.
Menúlecciones
En es a en ana se mues a el í ulo del ema jun o a una pequeña in oducción del
ema,seguidodelalis adelaslecciones.
T as selecciona una lección, y pulsa “Comenza lección”, se mues a el con enido de
dichalección.Elcon enidocons adeexplicacionesop egun as.
Sielcon enidoesunaexplicaciónsemos a ácomoenlasiguien eimagen.
Con enidodeexplicación
80
Si po el con a io el con enido es una p egun a a ia á del ipo de p egun a que se
a e.Encasodese de ipo es :
P egun a ipo es
Silasp egun assonde ipocódigoo iposin axis end ánlamismaapa iencia:
P egun as ipocódigoosin axis
81
Ambas is as de p egun as ienen un o ma o simila . En la pa e cen al se mues a el
enunciado de la p egun a y debajo el campo de espues a que a ía en unción del ipo: lis a
de opciones en el caso del ipo es y en el es o un campo de ex o donde esc ibi el código.
Además,alade echadelcampode espues asiemp eapa ecenlosmismosbo ones.
●Resol e :Pa acomp oba la espues ain oducida.
●Ayuda: Mues a un consejo en caso de exis i pa a esponde de o ma co ec a a la
p egun a.
T as con es a se mos a á un mensaje con el esul ado de la p egun a. En caso de se
co ec a, y mos a el co espondien e mensaje, se ac i a án los bo ones necesa ios pa a pode
con inua con la lección. En caso con a io se mos a á el mensaje indicando que se ha allado
ynoseac i a ándichosbo ones.
Si la p egun a es de ipo código, además de apa ece el mensaje comunicando el e o ,
se mos a á un bo ón con más in o mación pa a ayuda a esponde co ec amen e a la
p egun aen uncióndele o p oducido.
T as acaba la lección po comple o, se mos a á una en ana elici ando el abajo y
despuéslaaplicación ol e áalMenúde emas.
Felici ación
82
C)Ob enciónycompilacióndelahe amien a
Como ya se ha dicho an e io men e, es a he amien a es á disponible en
h ps://gi hub.com/Khe du/TFG/ bajo licencia MIT, pa a u iliza la es necesa io desca ga la y
compila la.
Una ez desca gado como ‘.zip’ se descomp ime. A con inuación se ab e el e minal
y desde la aíz del p oyec o se ejecu a el comando m n package.m n es el nomb e del
ejecu able de ma en en el equipo. Si no es á con igu ado como una a iable del sis ema hab á
queesc ibi la u acomple adedondeseencuen a.
T as el paso an e io , en el di ec o io desde donde se ejecu ó la ins ucción apa ece á
unaca pe a‘ a ge
’,lacualcon iene2a chi osconlaex ensión‘.ja ’.
Tu o ialesIn e ac i os0.0.1SNAPSHOT.ja
Tu o ialesIn e ac i os0.0.1SNAPSHOTja wi hdependenc
ies.ja
Pa au iliza lahe amien aesnecesa ioejecu a elsegundoconlasen encia:
ja aja <nomb e>
83
