cfc calling in browsers

If you ever asked yourself how to take a quick look inside a coldfusion cfc directly in a browser, check this out. If your cfc is in the webroot you can call it of course in a browser as usual:

http://www.domain.com/path/example.cfc

If you call a cfc this way the „cfc explorer“ appeares on stage and shows you auto-generated documentation of the cfc.
Additonally you can invoke a function directly in a browser:

http://www.domain.com/example.cfc?method=examplefunction

A request like this will actually invoke the method specified as url-parameter „method“.
Take care: the cffunction access-attribute must be specified as remote.

quick tutorial: more memory for tomcat/railo-server

Here’s a short howto for upping tomcat/railo-server’s memory:

The secret’s in tomcat’s JAVA_OPTS variable (java runtime options), which is defined in the catalina-startup-script.
You should be able to find this catalina.sh named script in /<tomcat-install-dir>/bin/catalina.sh
Have a look at the file and grep for JAVA_OPTS, you’ll find the following line:

JAVA_OPTS="$JAVA_OPTS -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager"

Now you can add some startup-parameters like this:

JAVA_OPTS="$JAVA_OPTS -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Xms128m -Xmx512m"

Look for more detailed information at this wiki-section at apache.org

Hier geht es zur deutschen Version dieser Anleitung.

Tutorial: Tomcat und Railo 3.1 mehr Speicher zuweisen

Fix gemacht, hier eine kleine Anleitung, wie man Railo/Tomcat mehr Speicher spendiert:

Das Geheimnis liegt in der JAVA_OPTS Variable (Java runtime options) vom Tomcat-Server. Diese wird in definiert im Catalina Startup-Script, das man normalerweise unter dem Pfad /<Tomcat-Installationsverzeichnis>/bin/catalina.sh finden können sollte. Sucht man in der Datei nun nach JAVA_OPTS, findet man schnell die richtige Stelle:

JAVA_OPTS="$JAVA_OPTS -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager"

Diese Zeile kann jetzt durch Start-Parameter erweitert werden:

JAVA_OPTS="$JAVA_OPTS -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Xms128m -Xmx512m"

Für alle Interessierten gibt’s hier bei apache.org noch detaillierte Informationen.

Here’s the english version of this post.

Coldfusion: Dubletten in einer Liste entfernen (CFML)

Aus aktuellem Anlass, weil ich’s grad mal wieder benötigt habe: ein kleines Code-Snippet zum Eliminieren von Dubletten in Listen. Es kommt ja immer wieder vor, dass man eine Liste hat, die doppelte Werte enthält. Manchmal benötigt man aber zum Weiterverarbeiten eine Liste, in der keine doppelten Einträge mehr vorhanden sind.
Das geht einfach und fix mit einem Loop über ein Struct:

<cfset myListWithDoubles = "1,1,5,4,6,1,4,6,12,4,5" />
<!--- elimate double values via struct --->
<cfset myStruct = StructNew()>
<cfloop index="idx" list="#myListWithDoubles#">
<cfset myStruct[idx] = "">
</cfloop>
<!--- convert back to a list --->
<cfset myListWithoutDoubles = StructKeyList(myStruct)>

CFML-Dokumentation jetzt als AIR-Applikation

Drüben bei cfmldocs.com gibt es nun eine wirklich sehr praktische Sache: eine CFML-Language-Referenz als AIR-Applikation.
Schlicht und schnörkellos, perfekt übersichtlich gemacht und mit schöner Suche, die direkt bei der ersten Buchstabeneingabe alle Funktionen und Tags filtert. Das Teil schlägt alle mir bekannten Online-Docs um Längen, man kommt pfeilschnell zum gesuchten Ziel.

Also unbedingt hinsurfen und installieren: http://cfmldocs.com/air/index.html
Schneller war nachschlagen nie.

AIr-Applikation CFML-Docs

AIr-Applikation CFML-Docs

Verzeichnis auflisten mit cfdirectory und mehrfachen Datei-Filtern

Aus aktuellem persönlichen Anlass hier ein Tipp zum Tag <cfdirectory>, das hat mich durchaus etwas Zeit gekostet: wenn man den Tag verwendet, will man oft auch einen Filter auf bestimmte Dateitypen setzen. Zum ersten Mal musste ich nun nicht nur nach einer Dateiendung, sondern nach mehreren Dateiendungen filtern. Die Lösung hierbei ist das Pipe-Symbol. Das nachstehende Beispiel zeigt die Funktionalität, klappt sowohl unter Railo als auch unter Adobe Coldfusion:

<cfset myPath = ExpandPath( './' ) />
<cfdirectory action="list" name="qFiles" directory="#myPath#" filter="*.txt|*.rtf">
<cfdump var="#qFiles#">

Das Beispiel extrahiert alle .txt- und .rtf-Dateien aus dem aktuellen Verzeichnis.

Reblog this post [with Zemanta]

richtig machen: XML-Objekt mit Coldfusion erzeugen

Ich habe öfters den Eindruck, dass die XML-Funktionen und -Tags, die man in CFML verwenden kann, nicht wirklich das Gelbe vom Ei sind. Wahrscheinlich kann man da drüber streiten, auf jeden Fall wollte ich Euch meine Optimal-Lösung für die Erzeugung eines richtigen XML aus einer Query nicht vorenthalten. Das Beispiel funktioniert sowohl unter Railo als auch unter Adobe Coldfusion:

<cfsilent>
<cfquery name="getCustomers" datasource="#request.datasource#">
select * from customers
</cfquery>
<!--- save xmlstring --->
<cfsavecontent variable="xmlString">
<customerlist>
<cfoutput query="getCustomers">
<customer id="#pkcustomers#">
<firstname><![CDATA[#Trim(firstname)#]]></firstname>
<lastname><![CDATA[#Trim(lastname)#]]></lastname>
</customer>
</cfoutput>
</customerlist>
</cfsavecontent>
<!--- save xml object --->
<cfxml variable="resultXml">
<cfoutput>#xmlString#</cfoutput>
</cfxml>
</cfsilent>
<cfdump var="#resultXml#">

Das Beispiel eignet sich hervorragend, um als Snippet abgelegt zu werden, viel Spass damit

Achtung bei Objekterstellung mit create object aus CFC (Railo 3.1.2)

Aus aktuellem Anlass ein kleiner Hinweis. Ich habe bis dato immer in meinem Code geschrieben:

<cfset myObj = CreateObject("component","dir.bla.blub.cfc").init(COOKIE.myID)>

Nun war ich nach dem Umstieg auf Railo 3.1.2 plötzlich mit der Fehlermeldung konfrontiert, dass die Komponente am angegebenen Ort nicht mehr gefunden wird:

invalid component definition, can't find dir.bla.blub.cfc

Die Lösung ist sehr simpel, ich wusste nur nicht, das Komponentenaufrufe auch ohne die Endung .cfc möglich sind. In der aktuellen Version würde Railo also webservice.bla.blub.cfc.cfc aufrufen wollen, deswegen muss man einfach diese Schreibweise verwenden:

<cfset myObj = CreateObject("component","dir.bla.blub").init(COOKIE.myID)>

An dieser Stelle herzlichen Dank an den Kollegen Michael Hnat von Bluegras für den Hinweis.

how-to: railo / resin installation on ubuntu minimal os

I hope this tutorial will save you a few hours of trouble, it’s a complete step-by-step tutorial of a railo/resin installation on Linux Ubuntu OS.
You’ll be able to deliver cfml via port 8600 and apache-port 80 as well.

If you prefer the german version, click here

First of all, you need some compliler-tools, wget for downloading the sources, the java enviroment and additional apache-modules (for example apxs2).

sudo apt-get install build-essential
sudo apt-get install apache2 sun-java6-jdk
sudo apt-get install wget
sudo apt-get install apache2-threaded-dev

Now go to http://www.getrailo.org/index.cfm/download/ and download the current railo server version (all os version without jre).
In my case this was today:

wget http://www.getrailo.org/down.cfm?item=/railo/remote/download/3.1.2.001/server/all/railo-3.1.2.001-resin-without-jre.tar.gz

Now move the tarball to /opt/ and extract the tarball:

mv railo-3.1.2.001-resin-without-jre.tar.gz /opt/.
tar -xvzf railo-3.1.2.001-resin-without-jre.tar.gz

Create a symlink and change the user for your convinience:

sudo ln -s railo-3.1.2.001-resin-without-jre railo
sudo chown -R username railo

Grats, Railo and Resin ist installed now. Please start the shellscript:

./opt/railo/bin/httpd.sh

Run the service in background using (currently railo/resin would stop after closing the shell)

./opt/railo/bin/httpd.sh &

Now you can browse to http://domain.com:8600 ant a test page should appear. From here you can navigate to the railo admin located under http://cfml.domain.com/railo-context/admin/web.cfm.

Now we have to explain apache that it should deliver cfml:

cd /opt/railo
sudo ./configure --with-apxs=/usr/bin/apxs2
sudo make
sudo make install

Warning: if an error occures while doing the configure or make, the makefile isn’t right. In that case please got to /opt/railo/ and rename the Makefile.in to Makefile.in.bak. Then rename the Makefile.am to Makefile.in:

root@blabla:/opt/railo# mv Makefile.in Makefile.in.bak
root@blabla:/opt/railo# mv Makefile.am Makefile.in

Then execute an „make clean“ in the directory /opt/railo/ and do the configure,make an make install again, it will run correctly now.
Remember to restart apache:

sudo /etc/init.d/apache2 restart

Now you can access the railo admin via apache, too: http://domain.com/railo-context/admin/web.cfm
Browse to http://domain.de/caucho-status to see the status of mod-caucho.

At least you have to configure the apache vhost and the resin.conf to provide multiple hosts. Here’s an example:

less /etc/apache2/sites-available/default

Define one more virtual host:

<VirtualHost *:80>
ServerName playgroundcfml.domain.com
ServerAdmin webmaster@localhost
DocumentRoot /var/www/playground/
<Directory /var/www/playground/>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>
ErrorLog /var/log/apache2/error.log
LogLevel warn
CustomLog /var/log/apache2/access.log combined
ServerSignature On
</VirtualHost>

Restart apache again and create the host entry on your local machine. The last point is to tell resin.conf the host:

less /opt/railo/conf/resin.conf

search for the host definition beginning:

<!-- configures the default host, matching any host name -->
<host id="" root-directory=".">

after the closing </host> you should add:

<host id="playgroundcfml.domain.com">
<root-directory>/var/www/playground</root-directory>
<web-app id="/">
<document-directory></document-directory>
</web-app>
</host>

Furthermore it is important to define the right port in the following tag – here’s the setting how apache webserver will talk to resin server:

<!-- define the servers in the cluster -->
<server id="" address="127.0.0.1" port="6800">
</code>

Resin will discover the changes automatically and restart the service, you'll not to do that on your own.
That's all, enjoy!

CFML ausliefern mit Railo / Resin Installation auf Ubuntu Server

Dieses How-To könnte Euch einiges an Arbeit sparen, ich zeige Schritt für Schritt auf, wie man einen Railo-Server mit Resin unter Ubuntu aufsetzt, cfm kann dann über Port 8600 ausgeliefert werden, außerdem konfigurieren wir den Apachen für die CFML-Auslieferung.

Please note: version in english is here

Ich gehe von einem minimal installiertem Ubuntu-System aus. Als erstes benötigt man das Paket build-essential, das uns die grundlegenden Tools für das Kompilieren zur Verfügung stellt, außerdem brauchen wir noch wget, Java und einige Komponenten (zum Beispiel apxs2), die beim normalen Apache nicht beiliegen, deswegen würde ich zu Beginn empfehlen:

sudo apt-get install build-essential
sudo apt-get install apache2 sun-java6-jdk
sudo apt-get install wget
sudo apt-get install apache2-threaded-dev

Geht nun auf http://www.getrailo.org/index.cfm/download/ und holt Euch die aktuelle Version vom Railo Server (all OS Version ohne JRE).

In meinem Fall war das heute:

wget http://www.getrailo.org/down.cfm?item=/railo/remote/download/3.1.2.001/server/all/railo-3.1.2.001-resin-without-jre.tar.gz

Verschiebt den Downlaod nach /opt/ und entpackt den Tarball dort:

mv railo-3.1.2.001-resin-without-jre.tar.gz /opt/.
tar -xvzf railo-3.1.2.001-resin-without-jre.tar.gz

Nun könnt Ihr einen Symlink einrichten und den User anpassen, um das Handling zu erleichtern:

sudo ln -s railo-3.1.2.001-resin-without-jre railo
sudo chown -R username railo

So, nun sollte Railo und Resin bereits fertig installiert sein, startet das Shellscript

./opt/railo/bin/httpd.sh

Dann solltet Ihr in der Konsole bereits die Ausgaben sehen. Als Hintergrundprozess laufen lassen könnt Ihr Railo/Resin mit

./opt/railo/bin/httpd.sh &

Damit läuft der Dienst auch weiter, wenn die Konsole wieder geschlossen wird. Wenn Ihr nun im Browser die URL http://domain.de:8600 aufruft, dann sollte bereits die Testseite mit Link zum Railo-Admin erscheinen.

Nun lassen wir den Apache noch cfml ausliefern, macht bitte als root Folgendes:

cd /opt/railo
sudo ./configure --with-apxs=/usr/bin/apxs2
sudo make
sudo make install

Achtung: sollte das so nicht fuktionieren und Fehler beim configure oder make auftauchen, dann ist das Makefile.in aus der Distribution nicht korrekt. In diesem fall geht Ihr nach /opt/railo/ und sichert Euch die Makefile.in weg, umbenennen in Makefile.in.bak und benennt Euch die Makefile.am um in Makefile.in

root@blabla:/opt/railo# mv Makefile.in Makefile.in.bak
root@blabla:/opt/railo# mv Makefile.am Makefile.in

Danach in /opt/railo/ ein make clean in der Konsole ausführen und das configure, make und make install von oben nochmals durchführen, es wird nun problemlos durchlaufen.

Nun muss der Apache neu gestartet werden:

sudo /etc/init.d/apache2 restart

Nun solltet Ihr den Railo-Administrator auch unter http://domain.de/railo-context/admin/web.cfm aufrufen können, CFML wird also auch vom Apachen ausgeliefert. Unter der URL http://domain.de/caucho-status seht Ihr die Informationen zum Mod Caucho.

Jetzt werden wir die Apache-Config und die Resin-Config anpassen, um multiple Hosts definieren zu können, anhand des nachstehenden Beispiels könnt Ihr vorgehen:

less /etc/apache2/sites-available/default

Hier definiert Ihr nun einen weiteren Virtual Host:

<VirtualHost *:80>
ServerName playgroundcfml.hetzner.de
ServerAdmin webmaster@localhost
DocumentRoot /var/www/playground/
<Directory /var/www/playground/>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>
ErrorLog /var/log/apache2/error.log
LogLevel warn
CustomLog /var/log/apache2/access.log combined
ServerSignature On
</VirtualHost>

Apache wiederum restarten nach dieser Änderung ( /etc/init.d/apache2 restart), wenn Ihr Euch dann einen entsprechenden Eintrag in Eure lokale Hosts gmacht habt, sollte das mit HTML-Files bereits klappen. Nun gleichen wir die Resin-Konfiguration noch an:

less /opt/railo/conf/resin.conf

Hier sucht Ihr am besten nach dem bereits definierten host, der so beginnt:

<!-- configures the default host, matching any host name -->
<host id="" root-directory=".">

Nach dem schließendem </host> dieser Definition fügt Ihr Euren neuen Eintrag hinzu:

<host id="playgroundcfml.hetzner.de">
<root-directory>/var/www/playground</root-directory>
<web-app id="/">
<document-directory></document-directory>
</web-app>
</host>

Wichtig ist desweiteren, dass der Port im nachstehenden Tag passt, denn dort wird festgelegt, wie der Apache Webserver mit dem Resin-Server spricht:

<!-- define the servers in the cluster -->
   <server id="" address="127.0.0.1" port="6800">
</code>

Resin sollte die Änderung der Config automatisch bemerken und sich selber restarten, danach seid Ihr auch in der Lage, CFML direkt für diese Vhost-Definition auszuführen. Viel Spass damit, ich hoffe, diese Anleitung hat Euch etwas Zeit gespart.