Iran Developers Network » ColdFusion http://www.irandevelopers.com IDN بزرگترین مرجع توسعه دهندگان ایران - آموزش زبانهای برنامه نويسی Mon, 23 Aug 2010 08:51:43 +0000 fa hourly 1 http://wordpress.org/?v=3.2.1 کار با پایگاه داده ها در کلدفیوژن http://www.irandevelopers.com/programming/coldfusiondatabase8711121620-1354/ http://www.irandevelopers.com/programming/coldfusiondatabase8711121620-1354/#comments Sat, 31 Jan 2009 12:50:56 +0000 admin http://www.irandevelopers.com/?p=1354

برای کار با پایگاه داده در کلدفیوژن، ابتدا باید برای آن پایگاه داده یک Datasource تعریف کنید. مثلا، برای ایجاد یک Datasource برای یک پایگاه داده Microsoft Access به روش زیر عمل می کنیم :

اگر در ویندوز ۹۸ هستید، به Control Panel -> Data Sources (ODBC) بروید.

اگر در ویندوز ۲۰۰۰ یا ویندوز XP هستید، به Control Panel -> Administrative Tools -> Data Sources(ODBC) بروید.

به System DSN بروید.

Add … را کلیک کنید.

در پنجره باز شده، “Microsoft Access Driver” را انتخاب کنید و روی Finish کلیک کنید.

در پنجره باز شده برای Datasource خود یک نام انتخاب کنید.

روی Select … کلیک کنید و فایل Access مورد نظر را انتخاب کنید.

به Start -> Programs -> Macromedia Coldfusion MX -> Administrator بروید.

کلمه عبور را وارد کنید.

از قسمت سمت چپ صفحه Data Sources را انتخاب کنید.

در Data Source Name نام Datasource خود را بنویسید.

از Driver ، گزینه ی JDBC-ODBC Bridge را انتخاب کنید و روی Add کلیک کنید.

در صفحه ای که ظاهر می شود، از لیست ODBC DSN، نام Datasource ی را که درControl Panel ایجاد کرده بودید را انتخاب کنید.

روی Submit کلیک مکنید.

برای نمایش داده های یک پایگاه داده در یک برنامه کلدفیوژن، از تق <CFQuery> به روش زیر استفاده می کنیم :

<CFQuery Datasource=”mydatasource” name=”query_name”>

Select field_1,field_2,field_3 from table_name

</CFQuery>

<CFOutput query=”query_name”>

Field 1 : #field_1# <BR>

Field 2 : #field_2# <BR>

Field 3 : #field_3# <BR>

</CFOutput>

Select field_1,field_2,field_3 from table_name یک عبارت SQL می باشد که سه فیلد field_1، field_2، و field_3 تمام رکوردهای جدول table_name از پایگاه داده ای که datasource “mydatasource” را به آن نسبت داده ایم را انتخاب می کند و سپس نتیجه را در متغیر query_name قرار می دهد.

<CFQuery …> یک حلقه چرخشی روی تمام رکوردهای متغیر query_name انجام می دهد و در هر مرحله مقادیر فیلد های هر رکورد به صورت متغیر در دسترس هستند و می توان عملیات مختلفی روی آن ها انجام داد. مثلا در کد بالا در هر مرحله مقادیر داخل ## با مقادیر واقعی فیلد های هر رکورد جایگزین می گردند و نمایش داده می شوند.

برای افزودن یک رکورد به یک پایگاه داده، مراحل زیر را باید انجام دهیم :

ابتدا یک فرم HTML ساده برای دریافت اطلاعات و ارسال آن ها به صفحه action ایجاد می کنیم :

<HTML>

<HEAD>

<TITLE>A Title</TITLE>

</HEAD>

<BODY>

<Form action=”add.cfm” method=”post”>

Name : <input type=”text” name=”name”>

<BR>

Last name: <input type=”text” name=”lastname”>

<BR>

<input type=”submit”>

</Form>

</BODY>

</HTML>

برای یادگیری مطالب بیشتر در این باره به کتاب ها و مراجع HTML مراجعه فرمائید.

سپس صفحه action را برای افزودن رکورد جدید به پایگاه داده ایجاد می کنیم (add.cfm) :

<CFQuery name=”add_query” datasource=”mydatasource”>

Insert Into my_table(

Field_1,

Field_2)

Values(

‘#form.name#’,

‘#form.lastname#’)

</CFQuery>

این کد یک رکورد به جدول my_table پایگاه داده ای که mydatasource به آن اشاره می کند، با مقادیر فیلد های form.name و form.lastname اضافه می کند. Form.name یک متغیر است که به مقدار Submit شده ی فیلد name در فرم HTML اشاره می کند و مقدار آن با مقدار اصلی عوض می گردد.

برای محدود کردن نمایش رکوردها ی یک پایگاه داده از عبارت SQL ی مانند مثال زیر استفاده می کنیم :

Select field1,field2,field3 from my_table where field1>0 AND field2=2

این عبارت نتایج را به نتایجی که مقدار field1 آن ها بزرگتر از صفر و مقدار field2 آن ها برابر ۲ می باشد، محدود می کند. برای اطلاعات بیشتر در این زمینه به کتاب ها و مراجع SQL مراجعه کنید.

کنترل جریان برنامه :

در این قسمت چند شیوه کنترل جریان برنامه را توضیح می دهم و بقیه را برای قسمت های بعدی می گذارم.

برای اجرا کردن کد یک فایل cfm دیگر در جایی از برنامه ی مان، از cfinclude به صورت زیر استفاده می کنیم :

<cfinclude template=”myfile.cfm”>

این دستور در هر کجا از برنامه قرار بگیرد، با کد های موجود در فایل myfile.cfm جایگزین می گردد.

برای هدایت کردن مرور گر به یک صفحه ی دیگر یا یک آدرس اینترنتی دیگر، از cflocation به صورت زیر استفاده می کنیم :

<cflocation url=”http://google.com/”>

<cflocation url=”mypage.cfm”>

این دستور ها باعث توقف اجرای برنامه جاری می شوند و مرورگر کاربر را به صفحه ی مشخص شده ( مثلا http://google.com در مثال اول و mypage.cfm در مثال دوم) می فرستد.

برای انجام دادن کار ها بر اساس شرط یا شروط، از ساختار cfif/cfelseif/cfelse به صورت زیر استفاده می کنیم :

<cfif condition1 >

Do something here if condition1 is true

<cfelseif condition2 >

Do another thing here if condition2 is true

<cfelse>

Do some other thing here if neither condition1 nor condition2 is true

</cfif>

در این جا اگر شرط condtion1 درست باشد، کد قسمت اول اجرا می گردد (و بقیه قسمت ها اجرا نمی گردند.) وگرنه اگر شرط condition2 درست باشد، کد قسمت دوم اجرا می گردد. و گرنه، کد قسمت آخر (سوم) اجرا می گردد.

شروط در کلدفیوژن عباراتی مثل Var1 EQ Var2 به معنی اینکه آیا مقدار Var1 با مقدار Var2 برابر می باشد یا نه و یا Var1 Is Not Var2 به معنی اینکه آیا مقادیر Var1 و Var2 نا برابر می باشند یا نه، هستند.

برای توقف اجرای برنامه از cfabort استفاده می کنیم :

<CFAbort>

]]> http://www.irandevelopers.com/programming/coldfusiondatabase8711121620-1354/feed/ 0 آموزش کلد فیوژن: انواع داده پیچیده : لیست ها http://www.irandevelopers.com/programming/colffusionlist8711121619-1352/ http://www.irandevelopers.com/programming/colffusionlist8711121619-1352/#comments Sat, 31 Jan 2009 12:49:56 +0000 macromediax http://www.irandevelopers.com/?p=1352

لیست ها در حقیقت رشته هایی هستند که مقادیر در آن به وسیله ی یک کاراکتر خاص از هم جدا شده اند. مانند مثال های زیر :

<cfset List_of_employees=”Hadi Moshayedi,Hossein Sharafi,Ben Forta”>
<cfset List_of_animals=”Elephant;Horse;Monkey”>
<cfset List_of_salaries=”12000,1300,5000,4000″>


به کاراکتری که مقادیر را از هم جدا می کند، Delimiter گویند. مثلا , (کاما) در مثال اول و ; در مثال دوم.
همانطور که در مثال های بالا دیدید، برای ایجاد لیست ها از <cfset … > استفاده می کنیم و مقادیر اولیه را تنظیم می کنیم.

افزودن مقادیر به یک لیست :
ساده ترین راه برای افزودن یک مقدار به یک لیست استفاده از تابع ListAppend به صورت زیر می باشد :

<cfset myList=”hadi,coldfusion,something”>
<cfset myList = ListAppend(myList,”php”)>


مثال بالا مقدار جدید “php” را به انتهای لیست اضافه می کند. این تابع، دارای پارامتر سومی می باشد که اختیاری می باشد و می تواند مانند مثال بالا ذکر نشود. این پارامتر سوم، Delimiter لیست را مشخص می کند و به صورت پیش فرض مقدار آن کاما می باشد. اگر در لیست از Delimiter ی به غیر از کاما استفاده کرده باشیم، برای افزودن یک مقدار به انتهای لیست به صورت زیر عمل می کنیم :

<cfset myList=”hadi;coldfusion;something”>
<cfset myList = ListAppend(myList,”php”,”;”)>


ListAppend مقدار جدید را به انتهای لیست اضافه می کرد. برای افزودن یک مقدار به ابتدای لیست، از تابع ListPrepend ، به همان صورت که از ListAppend استفاده می کردیم، استفاده می کنیم. به مثال های زیر توجه فرمائید :

<cfset myList=”a,b,c,d”>
<cfset myList = ListPrepend(myList,”0″)>
<!— Now, myList contains “0,a,b,c,d” —>

<cfset myList=”a;b;c;d”>
<cfset myList = ListPrepend(myList,”0″,”;”)>
<!— Now, myList contains “0;a;b;c;d” —>


برای افزودن مقداری به لیست در یک مکان مشخص، از تابع ListInsertAt استفاده می کنیم. به صورت زیر :

<cfset myList=”a,b,c,d”>
<cfset myList = ListInsertAt(myList,3,”h”)>


در مثال بالا، مقدار “h” سومین عنصر از لیست خواهد شد. مانند توابع دیگری که در این مقاله معرفی گردید، این تابع نیز دارای پارامتر اختیاری چهارمی هست که Delimiter لیست را مشخص می کند و مقدار پیش فرض آن کاما می باشد.

استخراج مقداری از لیست با استفاده از اندیس آن
برای استخراج مقدار عنصری از لیست با استفاده از اندیس آن، از تابع ListGetAt استفاده می کنیم. به صورت زیر :

<cfset myList=”a,b,c,d”>
<cfset second_item=ListGetAt(myList,2)>


کد بالا مقدار عنصر دوم لیست myList را در متغیر second_item قرار می دهد.
این تابع نیز دارای پارامتر اختیاری مشخص کننده Delimiter می باشد.

توابع ListFirst و ListLast به ترتیب مقدار عنصر اول، و مقدار عنصر آخر لیست را می دهند. تابع ListRest تمام عناصر یک لیست به غیر از عنصر اول را به عنوان خروجی می دهد.

<cfset myList=”a,b,c,d”>
<cfset first_item = ListFirst(myList)>
<!— first_item contains “a” now —>
<cfset last_item = ListLast(myList)>
<!— last_item contains “d” now —>
<cfset rest_items = ListRest(myList)>
<!— rest_items contains “b,c,d” now —>


برای بدست آوردن تعداد عناصر یک لیست از تابع ListLen به صورت زیر استفاده می کنیم :

<cfset myList=”a,b,c,d”>
<cfset myListLen = ListLen(myList)>
<!—Now, myListLen Equals 4 —>
<cfset myList=”a;b;c;d”>
<cfset myListLen = ListLen(myList,”;”)>
<!—Now, myListLen Equals 4 —>


برای حذف عنصری از لیست، از تابع ListDeleteAt به صورت زیر استفاده می کنیم :

<cfset myList=”a,b,c,d”>
<cfset myList = ListDeleteAt(myList,2)>


کد بالا عنصر دوم لیست را حذف می کند.

جستجو در لیست ها
برای پیدا کردن مقداری در لیست، از تابع ListFind استفاده می کنیم. این تابع موقعیت اولین عنصری که دارای مقدار دلخواه باشد را به عنوان خروجی بر می گرداند.

<cfset myList=”Hadi,Hossein,Ben”>
<cfset Pos1 = ListFind(myList,”Ben”)>
<!— Pos1 equals 3 now —>


تابع ListContains موقعیت اولین عنصری که دارای مقدار شامل عبارت مورد نظر را به عنوان خروجی بر می گرداند.

<cfset myList=”Hadi,Hossein,Ben”>
<cfset Pos2 = ListContains(myList,”se”)>
<!— Pos2 equals 2 now —>


کد بالا مقدار ۲ را در متغیر Pos2 قرار می دهد، زیرا عبارت Hossein شامل عبارت se می باشد.
ListFind و ListContains بین حروف بزرگ و کوچک تفاوت قائل می شوند. برای اینکه در جستجو حروف بزرگ و کوچک یکسان باشند به جای توابع بالا از توابع ListFindNoCase و ListContainsNoCase استفاده می کنیم.

لیست های دارای عناصر خالی
عناصر خالی، عناصری از لیست هستند که دارای هیچ مقداری نمی باشند. برای درک چگونگی کار با آن ها به مثال زیر توجه کنید :

<cfset myList = “Hadi,,Hossein,Ben,,”>


فکر می کنید لیست myList دارای چند عنصر می باشد؟ شاید فکر کنید که این لیست دارای شش عنصر می باشد، ولی کلدفیوژن عناصر دارای مقدار خالی را حساب نمی کند … پس لیست بالا از نظر کلدفیوژن سه عنصر دارد و “Ben” مقدار عنصر سوم آن می باشد.
برای ایجاد عناصر خالی، از کاراکتر فاصله به جای مقدار خالی استفاده کنید، مانند مثال زیر :

<cfset myList = “Hadi, ,Hossein,Ben, , “>


لیست بالا از نظر کلدفیوژن شش عنصر دارد.

برای تغییر مقدار عنصری از لیست از تابع ListSetAt مانند مثال زیر استفاده می کنیم :

<cfset myList = “Hadi,Hossein,Ben”>
<cfset myList = ListSetAt(myList,1,”Good Boy”)>
<!— myList = “Good Boy,Hossein,Ben” —>


کد بالا مقدار عنصر اول لیست را از Hadi به Good Boy تغییر می دهد.

مرتب سازی عناصر لیست
برای مرتب سازی عناصر یک لیست از تابع ListSort استفاده می کنیم. این تابع دارای دو پارامتر اجباری که اولی مشخص کننده لیست، و دومی مشخص کننده نوع مرتب سازی می باشد، می باشد.

<cfset myList = “a,d,c,v”>
<cfset myList = ListSort(myList,”text”)>


مقادیر قابل قبول برای پارامتر دوم عبارتند از “text”، “textnocase“، و “numeric“. مرتب سازی “text” بین حروف بزرگ و کوچک تفاوت قائل می باشد و در مرتب سازی حروف بزرگتر اول تر قرار می گیرند … “textnocase” برای حروف بزرگ و کوچک ارزش یکسانی قائل می باشد. “numeric” عناصر بر اساس ارزش عددی آن ها مرتب می سازد.
پارانتر سوم که اختیاری می باشد، ترتیب مرتب سازی را مشخص می سازد. “asc” (مقدار پیش فرض) مشخص می کند که مرتب سازی از ارزش کمتر به ارزش بیشتر باشد . “desc” برای مرتب سازی از ارزش بیشتر به ارزش کمتر به کار می رود. به مثال های زیر توجه کنید :

<cfset myList = “a,d,c,v”>
<cfset myList = ListSort(myList,”text”)>
<!— myList = “a,c,d,v” —>
<cfset myList = “a,B,c,d”>
<cfset myList = ListSort(myList, “textnocase”, “desc”)>
<!— myList = “d,c,B,a” —>

Delimiter های یک لیست
توابعی که برای کار با لیست ها به کار می روند تقریبا همه شان یک پارامتر آخری اختیاری دارند که Delimiter لیست را مشخص می سازد. Delimiter هایی که اکثرا مورد استفاده قرار می گیرند، عبارتند از : کاما، ;، |، ~ .
برای تغییر Delimiter یک لیست از تابع ListChangeDelims به صورت زیر استفاده می کنیم :

<cfset myList = “a;b;c;d”>
<cfset myList = ListChangeDelims(myList, “,”, “;”)>
<!— myList = “a,b,c,d” —>


پارامتر دوم مشخص کننده Delimiter جدید و پارامتر سوم مشخص کننده Delimiter قبلی می باشد. پارامتر سوم اختیاری می باشد و دارای مقدار پیش فرض کاما می باشد.

ایجاد حلقه(Loop) روی عناصر لیست
برای ایجاد حلقه روی عناصر یک لیست، به صورت زیر عمل می کنیم :

<cfset myList = “a;b;c;d”>
<cfoutput>
<cfloop list=”#myList#” index=”theElement” delimiters=”;” >
#theElement#<br>
</cfloop>
</cfoutput>


در کد بالا، theElement ابتدا مقدار “a” ، سپس مقدار “b” ، سپس مقدار “c” و در آخر مقدار “d” می گیرد و در هر مرحله کد بین <cfloop …></cfloop> را برای مقادیر theElement اجرا می کند. delimiters اختیاری می باشد و دارای مقدار پیش فرض کاما می باشد.

مناسب سازی یک لیست برای عبارات SQL
لیست زیر را در نظر بگیرید :

<cfset myList = “pear,lemon,orange,citron”>


و حال می خواهید لیست بالا در Query زیر استفاده کنید :

SELECT *
FROM Fruit
WHERE FruitName IN (‘pear’,'lemon’,'orange’,'citron’)


شما نمی توانید از لیست به این صورت استفاده کنید :

SELECT *
FROM Fruit
WHERE FruitName IN (#myList#)


زیرا عناصر لیست دارای ‘ (single quote) در دو طرفشان نمی باشند. برای این منظور، از تابع ListQualify استفاده می کنیم. مانند مثال زیر :

SELECT *
FROM Fruit
WHERE FruitName IN (#ListQualify(myList,”‘”)#))

موارد استفاده از لیست ها
اینکه کجا از لیست ها استفاده کنید، بستگی به خودتان و خلاقیت و نحوه ی تفکر شما دارد. اما من شخصا از لیست ها در موارد زیر استفاده می کنم :

  1. وقتی می خواهم در یک متغیر کوکی (cookie) بیش از یک مقدار قرار دهم. زیرا نمی توان به کوکی ها مقادیر آرایه ای داد، لیست ها در این جا یکی از انتخاب های خوب برای استفاده می باشد. روش دیگری هم وجود دارد که بعدا در باره ی آن صحبت خواهم کرد.
  2. هنگامی می خواهم لیستی از مقادیر را در یک فیلد از یک رکورد در پایگاه داده ذخیره کنم. در این مورد نیز نمی توان از آرایه ها استفاده کرد.

]]> http://www.irandevelopers.com/programming/colffusionlist8711121619-1352/feed/ 0 آموزش ColdFusion ،انواع داده ی پیچیده : آرایه ها http://www.irandevelopers.com/programming/coldfusionarray8711121617-1350/ http://www.irandevelopers.com/programming/coldfusionarray8711121617-1350/#comments Sat, 31 Jan 2009 12:47:57 +0000 macromediax http://www.irandevelopers.com/?p=1350

آرایه ها نیز مانند لیست ها، برای ذخیره سازی مقادیر متعدد، تحت یک نام می باشند. اما، برخلاف لیست ها، این ذخیره سازی در قسمت ها جدا از هم انجام می گیرد و مانند لیست ها تمام مقادیر در یک رشته ای از مقادیر جدا شده به وسیله ی حرف جدا کننده ذخیره نمی گردند.

لیست ها داده های ساده می باشند، چون فقط یک رشته می باشند، در حالی که آرایه ها داده های پیچیده می باشند، چون متشکل از چندین قسمت قابل آدرس دهی می باشند و دارای چنیدن مقدار مختلف می باشند.

ایجاد یک آرایه

برخلاف لیست، که یک رشته ساده می باشد، آرایه ها نوع داده ی پیچیده ای می باشند که توسط تابع ArrayNew() ایجاد می گردند. مانند مثال زیر :

<cfset myArray = ArrayNew(1) >

تکه کد بالا، یک آرایه ی یک بعدی ایجاد می کند و آن را به ArrayNew تخصیص می دهد. یک آرایه می تواند تا ۳ بعد داشته باشد.

ارجاع به عضوی از یک آرایه

برای دسترسی به عضوی از آرایه، مانند مثال زیر عمل می کنیم :

<cfoutput>#MyArray[2]#</cfoutput>

مثال بالا مقدار عنصر دوم آرایه را چاپ می کند. بر خلاف اکثر زبان های برنامه نویسی، اندیس آرایه در کلدفیوژن از یک شروع می شود.

افزودن عنصری به آرایه

برای افزودن عنصری به آرایه از ArrayAppend() به شکل زیر استفاده می کنیم :

<cfset myArray = ArrayNew(1)>

<cfset ArrayAppend(myArray,”apple”)>

به تفاوت ArrayAppend و ListAppend توجه کنید :

<cfset myList = ListAppend(myList, “apple”)>

<cfset ArrayAppend(myArray,”apple”)>

ListAppend مقدار لیست اصلی را تغییر نمی دهد، بلکه یک لیست جدید با یک مقدار جدید افزوده شده به انتهای آن ایجاد می کند. اما ArrayAppend تغییرات را روی آرایه ی اصلی اعمال می کند، و مقدار بازگشتی آن در صورت موفقیت تابع true می باشد و در غیر این صورت false می باشد. بنابراین شما حتی نیاز ندارید که مقدار بازگشتی را ذخیره کنید.

همچنین برای افزودن عنصری به ابتدای یک آرایه از تابع ArrayPrepend مانند مثال زیر استفاده می کنیم :

<cfset ArrayPrepend(myArray,”lemon”)>

شما همچنین می توانید عنصری را میان عناصر موجود اضافه کنید . مثلا فرض کنید آرایه ی ما دارای عناصر زیر باشد :

۱ : peach

2 : apple

شما می توانید عنصری را میان عناصر اول و دوم اضافه کنید . بدین منظور از تابع ArrayInsertAt به صورت زیر استفاده می کنیم :

<cfset ArrayInsertAt(myArray,2,”lemon”)>

پس از اجرای کد بالا آرایه ی ما دارای عناصر زیر خواهد بود :

۱ : peach

2 : lemon

3 : apple

شما همچنین می توانید یک عنصر برای آرایه بوسیله عمل تخصیص ایجاد کنید. مثلا، برای آرایه ی بالا، کد زیر را اجرا می کنیم :

<cfset myArray[4]=”blueberry”>

حال، آرایه ی ما دارای چهار عنصر زیر می باشد :

۱ : peach

2 : lemon

3 : apple

4 : blueberry

شما همچنین می توانید از مقدار دهی به برخی از عناصر صرف نظر کنید :

<cfset myArray[6]=”pomegranate”>

پس از اجرای کد بالا آرایه ما به صورت زیر می باشد :

۱ : peach

2 : lemon

3 : apple

4 : blueberry

5 : هیچ عنصری با اندیس پنج وجود ندارد

۶ : pomegranate

به آرایه ی بالا توجه کنید، هیچ عنصری با اندیس ۵ وجود ندارد و این به این معنی نیست که آرایه ی پنجم دارای مقدار خالی می باشد، فقط، هیچ عنصری با اندیس ۵ وجود ندارد.

حذف عنصری از یک آرایه

برای حذف عنصری از آرایه می توانید از تابع ArrayDeleteAt به صورت زیر استفاده کنید :

<cfset ArrayDeleteAt(myArray,2)>

تابع بالا عنصر دوم از آرایه را حذف می کند.

برای پاک کردن کل آرایه ، یعنی حذف تمام عناصر از تابع ArrayClear مانند زیر استفاده می کنیم :

<cfset ArrayClear(myArray)>

بدست آوردن اطلاعاتی در رابطه با آرایه :

برای تست کردن اینکه آیا هیچ عنصری در آرایه موجود می باشد یا نه ، از تابع ArrayIsEmpty به صورت زیر استفاده می کنیم :

<cfif ArrayIsEmpty(myArray)>

This Array is empty.

<cfelse>

This Array has some elements.

</cfif>

برای بدست آوردن تعداد عناصر یک آرایه از تابع ArrayLen بصورت زیر استفاده می کنیم :

<cfset numElements = ArrayLen(myArray) >

ArrayLen عناصر تعریف نشده را نیز حساب می کند.

پیدا کردن عنصری در آرایه :

برای پیدا کردن عناصر در یک لیست دو تابع ListFind و ListFindnocase وجود داشتند، ولی هیچ تابعی برای جستجو بر روی آرایه ها وجود ندارد. بنابراین، برای جستجو در یک آرایه، باید از cfloop مانند مثال زیر استفاده کرد :

<cfloop from=”۱” to=”#ArrayLen(myArray)#” index=”I”>

<cfif myArray[I] EQ “apple”>

<cfbreak>

</cfif>

</cfloop>

پس از اجرای کد بالا، I دارای اندیس عنصر دارای مقدار apple می باشد.

برخی توابع ریاضی برای آرایه ها :

تابع ArrayMin برای پیدا کردن کمترین مقدار موجود در آرایه به کار می رود.

تابع ArrayMax برای پیدا کردن بیشترین مقدار موجود در آرایه به کار می رود.

تابع ArraySum برای پیدا کردن مجموع مقادیر موجود در آرایه به کار می رود.

تابع ArrayAvg برای پیدا کردن میانگین مقادیر موجود در آرایه به کار می رود.

به عنوان مثال، به تکه کد زیر توجه کنید :

<cfset NumericArray=ArrayNew(1)>

<cfset NumericArray[1]=10>

<cfset NumericArray[2]=12>

<cfset NumericArray[3]=11>

<cfset NumericArray[4]=20>

<cfset NumericArray[5]=10>

<cfset Minimum=ArrayMin(NumericArray)>

<cfset Maximum=ArrayMax(NumericArray)>

<cfset Sum=ArraySum(NumericArray)>

<cfset Avg=ArraySum(NumericArray)>

تعویض جای عناصر یک آرایه :

فرض کنید عناصر آرایه ی ما به صورت زیر باشند :

۱ : peach

2 : lemon

3 : apple

4 : blueberry

برای تعویض جای عنصر اول و عنصر سوم ، از تابع ArraySwap به صورت زیر استفاده می کنیم :

<cfset ArraySwap(myArray,1,3)>

حال عناصر آرایه ی ما به صورت زیر می باشند :

۱ : apple

2 : lemon

3 : peach

4 : blueberry

مرتب سازی عناصر یک آرایه :

همانند لیست ها، شما می توانید عناصر یک آرایه را به راحتی مرتب کنید :

<cfset ArraySort(myArray,”text”,”asc”>

پس از اینکه کد بالا اجرا شد، آرایه دارای عناصر به ترتیب زیر می باشد :

۱ : apple

2 : blueberry

3 : lemon

4 : peach

اگر عنصر تعریف نشده ای در آرایه موجود باشد، و شما بخواهید آرایه را مرتب کنید، کلدفیوژن یک خطا ایجاد می کند.

همانند برای ListSort()، دومین پارامتر تابع ArraySort، نوع مرتب سازی که می خواهید انجام دهید را مشخص می کند :

· Numeric : آرایه را به صورت عددی مرتب سازی می کند. اگر عنصری از آرایه نتواند به یک عدد تبدیل شود، یک خطا رخ می دهد.

· Text : آرایه را به صورت الفبایی مرتب سازی می کند، و حساس به بزرگی و کوچکی حروف می باشد.

· Textnocase : آرایه را به صورت الفبایی مرتب سازی می کند، و حساس به بزرگی و کوچکی حروف نمی باشد.

سومین پارامتر تابع ArraySort() می تواند “asc” و یا “desc” باشد. بستگی دارد به اینکه شما می خواهید آرایه را به صورت از کوچک به بزرگ مرتب کنید و یا از بزرگ به کوچک مرتب کنید.

تغییر اندازه ی یک آرایه :

هر وقت که شما یک عنصر را به آرایه اضافه می کنید، مقداری حافظه از سرور کلدفیوژن برای آن عنصر تخصیص می دهید. اگر مقدار حافظه ی کافی در محل جاری آرایه موجود نباشد، کلدفیوژن مجبور است که تمام آرایه را یک جا به محل حافظه ی دیگری انتقال دهد. اگر تعداد زیادی عنصر در آرایه موجود باشد، این عملیات از CPU و حافظه بیهوده استفاده می کند.

به خاطر بهنیه سازی، اگر تعداد عناصر یک آرایه را از اول می دانید، می توانید قبل از شروع به افزودن عناصر به آرایه بوسیله ی تابع ArrayResize حافظه مورد نیاز را از قبل اختصاص دهید. مانند مثال زیر :

<cfset ArrayResize(myArray, 500)>

برای بدست آوردن حداکثر بهینه سازی، از تابع ArrayResize بلافاصله بعد از استفاده از ArrayNew استفاده کنید.

تبدیل بین آرایه ها و لیست ها

برای تبدیل یک آرایه ی موجود به یک لیست جدید، از تابع ArrayToList به صورت زیر استفاده می کنیم :

<cfset NewList = ArrayToList(myArray)>

برای تبدیل یک لیست موجود به یک آرایه ی جدید، از تابع ListToArray به صورت زیر استفاده می کنیم :

<cfset NewArray = ListToArray(myList)>

]]> http://www.irandevelopers.com/programming/coldfusionarray8711121617-1350/feed/ 0 درک و رفع نقص پیام های error در کلد فیوژن http://www.irandevelopers.com/programming/coldfusionerror8711121616-1348/ http://www.irandevelopers.com/programming/coldfusionerror8711121616-1348/#comments Sat, 31 Jan 2009 12:46:05 +0000 macromediax http://www.irandevelopers.com/?p=1348

پیام خطای : ColdFusion—Access Denied

این پیام خطا هنگام کار با یکی از پایگاه های داده فایلی مایکروسافت (مانند Access و یا FoxPro) رخ میدهد .هنگامی که کلدفیوژن در حال دسترسی به پایگاه داده ها از طریق Data Source باشد . این ایراد معمولا زمانی رخ میدهد که شما مشغول رونویسی بانک داده ها از طریق FTP و یا کپی روی آن هستید .

بهترین راه حل این مشکل کنار گذاشتن coldfusion services و یا غیر فعال کردن Maintain Database Connection از بخش data source در ColdFusion Administrator است .

پیام خطای : ColdFusion—Operation must use an updateable query error

این ایراد زمانی رخ می دهد که سعی در اجرای یک صفحه کلد فیوژن دارید که کارش آپدیت یا پاک کردن رکوردی از یک بانک اطلاعاتی مایکروسافت مثل اکسس است.این ایراد بصورت معمول زیاد رخ میدهد . چون کلدفیوژن اجازه دسترسی گسترده در سطح سیستم عامل شبکه برای نوشتن روی بانک اطلاعاتی ندارد .

برای حل این مسئله در ویندوز NT به آدرس زیر بروید :

Start > Settings > Control Panel > Services و روی ColdFusion Application Server service کلیک کنید و start-up account را بخاطر بسپارید . در حالت پیش فرض باید System Account باشد .بعد به پوشه ای بروید که فایل بانک اطلاعاتی در آن است و به آن account اجازه دسترسی به پوشه مورد نظر را بدهید. حتی اگر کنترل پوشه میگوید همه (everyone) حق دسترسی دارند باز هم باید اکانت ColdFusion startup را اضافه کنید

]]> http://www.irandevelopers.com/programming/coldfusionerror8711121616-1348/feed/ 0 دستورهای شرطی در ColdFusion http://www.irandevelopers.com/programming/coldfusionifthen8711121614-1346/ http://www.irandevelopers.com/programming/coldfusionifthen8711121614-1346/#comments Sat, 31 Jan 2009 12:44:58 +0000 macromediax http://www.irandevelopers.com/?p=1346

برای تصمیم گیری بر اساس شرایط مختلف می توان از ساخت if/else/elseif استفاده کرد :

<cfif condition>

<!— Some code to go if condition is TRUE —>

</cfif>

ColdFusion چک می کند که آیا شرط condition دارای مقدار True می باشد یا False . اگر این مقدار True باشد کد بین جفت تق را اجرا می کند. مانند مثال زیر :

<CFIF myVar EQ MyOtherVar>

Two Variables are equal to eachother .

</CFIF>

اگر بخواهید coldfusion یک کد خاص برای مواقعی که شرط False می باشد را اجرا کند از ساختار زیر استفاده می کنیم :

<CFIF myVar EQ MyOtherVar>

Two variables are equal to eachother.

<CFELSE>

<!— This part will be executed if the condition is FALSE —>

Two variables are not equal.

</CFIF>

شما می توانید این ساخت شرطی را با افزودن cfelseif گسترش دهید :

<CFIF myVar Greater Than MyOtherVar>

<cfoutput>#myvar# > #myotherVar# </cfoutput>

<CFELSEIF myVar EQ MyOtherVar>

<cfoutput> #myVar# = #MyOtherVar# </cfoutput>

<CFELSE>

<cfoutput> #myVar# < #myOtherVar# </cfoutput>

</CFIF>

اگر شرط موجود در cfif صحیح نباشد شرط مجود در cfelseif های موجود به ترتیب چک می شود. اگر هیچ کدام درست نباشند ٬ کد موجود پس از cfelse اجرا می شود

]]> http://www.irandevelopers.com/programming/coldfusionifthen8711121614-1346/feed/ 0 آموزش ColdFusion ، ساختار Switch/Case http://www.irandevelopers.com/programming/coldfusionswtichcase8711121613-1344/ http://www.irandevelopers.com/programming/coldfusionswtichcase8711121613-1344/#comments Sat, 31 Jan 2009 12:43:38 +0000 macromediax http://www.irandevelopers.com/?p=1344

ساختار Switch/Case یک عبارت را در برابر چندین شرط، ارزیابی می کند و سپس کد مربوطه را اجرا می کند.

مثلا، تکه کد زیر را در نظر بگیرید :

<cfif myVar EQ 1>

One

<cfelseif myVar EQ 2>

Two

<cfelseif myVar EQ 3>

Three

</cfif>

تکه کد بالا مقدار myVar را سه بار ارزیابی می کند و هر بار تست می کند که آیا مقدار آن برابر مقدار خاصی هست یا نه. کد بالا را می توان به صورت بهتر می توان نوشت :

<cfswitch expression=”#myVar#”>

<cfcase value=1>

One

</cfcase>

<cfcase value=2>

Two

</cfcase>

<cfcase value=3>

Three

</cfcase>

</cfswitch>

هر دو کد یک کار واحد انجام می دهند اما ساختار cfswitch بهینه تر می باشد، زیرا مقدار متغیر myVar به جای سه بار، یک بار ارزیابی می کند. کلدفیوژن عبارات cfswitch را بسیار بهینه تر از عبارات cfif اجرا می کند ، زیرا برای اجرای cfif، هر دفعه هر مقدار هر عبارت شرطی را ارزیابی می کند (true یا false) تا آنجا مقدار یک عبارت true شود، ولی cfswitch ابتدا مقدار عبارت را ارزیابی می کند (یک بار) و سپس قسمت مطابق با آن را اجرا می کند.

مقادیر ذکر شده در cfcase باید از نوع ثابت باشند و نمی توانند متغیر و یا عبارت باشند. به عنوان مثال، تکه کد زیر مجاز نیست :

<cfswitch expression=”#MyVar#”>

…

<cfcase value=”#۱+۱#”>

Two

</cfcase>

…

</cfswitch>

در کد زیر cfdefaultcase برابر cfelse در ساختار cfif می باشد.

<cfswitch expression=”#myVar#”>

<cfcase value=1>

One

</cfcase>

<cfcase value=2>

Two

</cfcase>

<cfcase value=3>

Three

</cfcase>

<cfdefaultcase>

Some Other Number

</cfdefaultcase>

</cfswitch>

کد بالا به این معناست که اگر هیچ یک از مقادیر cfcase برابر مقدار عبارت نبودند، بلوک کد مربوط به cfdefaultcase را اجرا کند.

اگر چه ساختار های cfswitch مزایای زیادی دارند، اما در اغلی اوقات نمی توان از آن به جای cfif استفاده کرد. مثلا به کد زیر توجه کنید :

<cfif MyVar GREATER THAN myOtherVar>

<cfoutput>#MyVar#</cfoutput>

<cfesleif myVar EQUAL myOtherVar>

<cfoutput>#MyVar+MyOtherVar#</cfoutput>

<cfelse>

<cfoutput>#MyOtherVar#</cfoutput>

</cfif>

این کد را نمی توان به وسیله ساختار cfswitch نوشت. زیرا عبارات شرطی کد بالا چیزی بیشتر از یک مقایسه ی برابری ساده می باشند.

]]> http://www.irandevelopers.com/programming/coldfusionswtichcase8711121613-1344/feed/ 0 آموزش کلد فیوژن : متغیر های Client و Session http://www.irandevelopers.com/programming/coldfusionsessionclientvar8711121611-1342/ http://www.irandevelopers.com/programming/coldfusionsessionclientvar8711121611-1342/#comments Sat, 31 Jan 2009 12:42:04 +0000 macromediax http://www.irandevelopers.com/?p=1342 از من درخواست شده بود که در باره ی متغیرهای Session بنویسم. از آن جایی که بین متغیر های Session و Client و تشابه هایی وجود دارد، آن ها را در یک مقاله توضیح می دهم.

۱- متغیرهای Client

متغیرهای Client به جای اینکه در سیستم کاربر ذخیره گردد، در سرور Coldfusion ذخیره می گردند. متغیرهای Client با مرورگر کاربر یک جفت تشکیل می دهند و برای هر مرورگر یک Client.MyVar وجود دارد. برای این که سرور کلدفیوژن بتواند تشخیص بدهد که کدام متغیر Client مربوط به کدام مرورگر می باشد، از یک جفت متغیر CFID و CFTOKEN استفاده می کند. بعدا در باره ی این دو متغیر بحث خواهیم کرد.

برای تنظیم حداکثر مدت زمان باقی ماندن متغیرهای Client، از Administrator کلدفیوژن استفاده می شود. مقدار پیش فرض ۹۰ روز می باشد. شما می توانید این مقدار تا یک روز پایین بیاورید. اگر از متغیرهای مربوط به CFID و CFTOKEN خاصی ، در این مدت زمان استفاده نگردد، متغیرهای مربوط به آن از روی سرور پاک می گردد.

برای استفاده از متغیرهای Client، ابتدا باید با استفاده از cfapplication، مقدار clientManagement را true کنید. به این صورت :

<cfapplication clientManagement=”true” … >

سپس، برای ایجاد متغیرهای Client از CFSet و یا CFParam به صورت زیر استفاده کنید :

<CFSet Client.MyVar=1>

<CFParam name=”Client.MyVar” default=”۱”>

یکی از کاربردهای جالب متغیرهای Client، متغیر Client.LastVisit می باشد که خود به خود ایجاد می گردد و مقدار آن خود به خود به روز می گردد و دارای مقدار تاریخ آخرین روزی است که وب سایت جاری توسط یک مرورگر در خواست شده است. برای استفاده از این متغیر، به مثال زیر توجه کنید :

<CFOUTPUT>

Welcome back to the Web

SuperShop, your last visit

was on #DateFormat(Client.LastVisit)#.

</CFOUTPUT>

برای حذف کردن یک متغیر Client، از تابع DeleteClientVariable() به صورت زیر استفاده کنید :

<cfset result=DeleteClientVariable(“MyVar”)>

2- متغیر های Session

متغیرهای Session در RAM سیستمی که سرور کلدفیوژن در آن اجرا می شود ذخیره می گردند و مانند متغیرهای Client برای هر مرورگر مجزایی متغیرهای Session مجزا ایجاد می شوند و این متغیرها نیز، توسط متغیرهای CFToken و CFID از هم باز شناخته می شوند.

تفاوت های بین متغیرهای Client و متغیرهای Session عبارت است از :

· متغیرهای session قادر به ذخیره سازی انواع داده ی پیچیده مانند Structure ها و آرایه ها می باشند، ولی متغیر های Client تنها قادر به ذخیره سازی داده های ساده مانند رشته های متنی و اعداد می باشند.

· متغیرهای session نیاز به استفاده از CFLock می باشند ولی متغیر های Client نیازی به استفاده از CFLock ندارند. (بعدا در این مقاله استفاده از CFLock را شرح خواهم داد.)

· مدت عمر متغیرهای کمتر از مدت عمر متغیرهای Client می باشد.

· اگر سرور Coldfusion را از نو راه اندازی کنیم، متغیرهای Session از بین خواهند رفت ولی متغیر های Client هم چنان باقی خواهند ماند.

· متغیرهای Session از لحاظ فضای اشغالی هیچ محدودیتی ندارند در حالی که متغیرهای Client به ۳۲ کیلوبایت محدود هستند.

برای استفاده از متغیرهای Session، ابتدا باید SessionManagement را به صورت زیر “true” کنیم :

<cfapplication sessionManagement=”true” … >

اگر می خواهید مقدار پیش فرض مدت عمر متغیرهای Session را تغیر دهید، مقدار SessionTimeout را به روش زیر تغییر دهید :

<cfapplication sessionmanagement=”true” sessiontimeout=”#CreateTimeSpan(0,0,20,0)#” …>

مثلا مثال بالا حداکثر مدت طول عمر متغیر های از نوع Session را برابر ۲۰ دقیقه قرار می دهد. ( در تابع CreateTimeSpan، پارامتر اول تعداد روزها، پارامتر دوم، ساعات، پارامتر سوم، دقیقه ها و پارامتر آخر ثانیه ها می باشند.)

برای حذف یک متغیر Session از تابع StructDelete به روش زیر استفاده کنید :

<cfset Result=StructDelete(Session,”MyVar”)>

برای حذف تمام متغیرهای Session، از cfapplication به روش زیر استفاده کنید :

<cfapplication sessiontimeout=”#CreateTimeSpan(0,0,0,0)#” …>

متغیرهای Session در حافظه ی سرور کلدفیوژن ذخیره می گردند و کاربرهای مختلف ممکن است خواهان دسترسی به آن ها در یک زمان خاصی باشند. برای اینکه در مدیریت حافظه اختلال به وجود نیاید، باید هنگام خواندن مقدار و یا مقدار دهی این متغیرها استفاده از حافظه را به یک کاربر خاص محدود کرد و پس از آن که این کاربر خاص کار بر روی مقادیر متغیرها را تمام کرد، نوبت به کاربر دیگر می رسد.

برای این کار، از cflock استفاده می کنیم. برای مقدار دهی به متغیرهای session، از cflock به صورت زیر استفاده می کنیم :

<CFLock name=”Session_MyVar”

type=”Exclusive”

timeout=”۱۰”

throwOnTimeOut=”Yes”>

<CFSet Session.MyVar=”۱”>

</CFLock>

برای خواندن مقدار یک متغیر session از cflock به صورت زیر استفاده می کنیم :

<CFLock name=”Session_MyVar”

type=”READONLY”

timeout=”۱۰”

throwOnTimeOut=”Yes”>

<CFSet Variables.MyVar=Session.MyVar>

</CFLock>

]]> http://www.irandevelopers.com/programming/coldfusionsessionclientvar8711121611-1342/feed/ 0 دفاع از کلدفیوژن در برابر پدرخوانده اش http://www.irandevelopers.com/programming/defahazcoldfusion8711121609-1340/ http://www.irandevelopers.com/programming/defahazcoldfusion8711121609-1340/#comments Sat, 31 Jan 2009 12:40:15 +0000 macromediax http://www.irandevelopers.com/?p=1340

در این روزها خیلی می بینیم که بعضی ها میگن از کلدفیوژن به جاوا اسباب کشی کنید . چرا ؟ یکی از دلایل کمبود شناخت درباره کلدفیوژن و طرز کارشه . بیاید با یک رابطه بین این دو برنامه شروع کنیم :

برنامه های نوشته شده در CF اصالتا جاوا هستند یا مقدار خیلی کمی فرق دارند .CF روی یک سرورJ2EE اجرا میشود که یک برنامه تایید شده توسط شرکت سان میباشد که کدبایت جاوا را اجرا میکند . این کدبایت جاوا از کامپایل کد های CFML نوشته شده توسط شما برجود میاید. به زبان ساده تر میشه گفت که CFML یک ساختار زبان برای برنامه نویس است، نه برای سرور . در هنگام اجرا کلدفیوژن برنامه را به جاوا کامپایل کرده و بنام CF اجرا میکند . در این لحظه هیچ CFML ای وجود ندارد و کدی که اجرا میشود تماما جاوا است . نه بیشتر و نه کمتر ! بهمین سادگی .

برنامه کلدفیوژن شما یک برنامه جاوا است که با کد های ساده تر کلدفیوژن آنرا نوشته اید . در اصل کلدفیوژن یکی از ابزارهای کمکی جاوا بحساب میاید .مثلا در جاوا برای وصل شده به پایگاه داده باید ۱۰ خط کد بنویسید ، در حالیکه این کار با یک تگ کلدفیوژن قابل انجام است . یا در جاوا برای فرستادن ایمیل SMTP با استفاده از JAVAMail API باید کلی خودتونو برای نوشتن کد خسته کنید ، در حالیکه اینکار با یک تگ تنها در کلدفیوژن انجام میشود . خوب دوباره نویسی را پس کنار بگذارید .

پس cf برنامه نویسی جاوا راگسترش داده و ساده تر میکند . وبرنامه های CF نوعی جاوا هستند و با برنامه هایی که در زبان سطح پایین تر جاوا نوشته شده اند فرقی ندارند .کلدفیوژن همچنین میتواند از API های جاوا ، class های جاوا ، تگ های JSP و JavaBeans نیز استفاده کند .چون خودش فرزند جاواست.

]]> http://www.irandevelopers.com/programming/defahazcoldfusion8711121609-1340/feed/ 0