cffunction

<cffunction
name = "method name"
access = "method access"
consumes="MIME types"
description = "function description"
displayName = "name"
httpMethod="GET|PUT|POST|DELETE"
hint = "hint text"
output = "yes|no"
produces="MIME type"
modifier="abstract|final|static"
returnFormat = "not specified|JSON|plain|WDDX"
returnType = "data type"
roles = "securityRoles"
restPath="sub-resource path"
secureJSON = "yes|no"
verifyClient = "no|yes">

<cffunction
name="getEmployees"
access="remote"
returnType="query"
hint="This query returns all records in the employee database. It candrill-down or narrow the search, based on optional input parameters.">

<cfcomponent> 
<cffunction name="getEmp"> 
<cfquery 
name="empQuery" datasource="ExampleApps" > 
SELECT FIRSTNAME, LASTNAME, EMAIL 
FROM tblEmployees 
</cfquery> 
<cfreturn empQuery> 
</cffunction> 
<cffunction name="getDept"> 
<cfquery name="deptQuery" datasource="ExampleApps" > 
SELECT * 
FROM tblDepartments 
</cfquery> 
<cfreturn deptQuery> 
</cffunction> 
</cfcomponent>

<!--- component with attributes rest and restpath --->
<cfcomponent rest="true"
             restpath="/crudService">

    <!--- handle GET request (httpmethod),
          take argument in restpath(restpath={customerID}),
          return query data in json format(produces=text/json) ---> 
    <cffunction name="getHandlerJSON"
                access="remote"
                httpmethod="GET"
                restpath="{customerID}"
                returntype="query"
                produces="application/json">
                    
        <cfargument name="customerID"
                    required="true"
                    restargsource="Path"
                    type="numeric"/>
    
        <cfset myQuery = queryNew("id,name", 
                                  "Integer,varchar",
                                  [[1, "John"], [2, "Doe"]])>
        <cfquery dbtype="query"
                 name="resultQuery">
            select * from myQuery where id = #arguments.customerID#
        </cfquery>
        <cfreturn resultQuery>
    </cffunction>   
</cfcomponent>

<cffunction name="getFullName" output="false" access="public" returnType="string">
    <cfargument name="firstName" type="string" required="false" default="" />
    <cfargument name="lastName" type="string" required="false" default="" />

    <cfset var fullName = arguments.firstName & " " & arguments.lastname />

    <cfreturn fullName />
</cffunction>

<cfset fullName = getFullName(firstName="John", lastName="Adams") />

<cfoutput>
    Good morning, #fullName#!
</cfoutput>

<cfcomponent output="false">
    <cfset this.name = "AuthDemo">
    <cfset this.sessionManagement = true>
    <cfset this.sessionTimeout = createTimeSpan(0, 0, 30, 0)>
</cfcomponent>

    <cffunction name="login" access="public" returntype="struct">
        <cfargument name="username" type="string" required="true">
        <cfargument name="password" type="string" required="true">
        
        <cfset var result = {success: false, message: ""}>
        
        <!--- Simple validation: admin/admin123 --->
        <cfif arguments.username EQ "admin" AND arguments.password EQ "admin123">
            <cfset session.user = {
                username: arguments.username,
                loginTime: now()
            }>
            <cfset result.success = true>
            <cfset result.message = "Login successful!">
        <cfelse>
            <cfset result.message = "Invalid username or password">
        </cfif>
        
        <cfreturn result>
    </cffunction>
    
    <cffunction name="isLoggedIn" access="public" returntype="boolean">
        <cfreturn structKeyExists(session, "user")>
    </cffunction>
    
    <cffunction name="logout" access="public" returntype="void">
        <cfif structKeyExists(session, "user")>
            <cfset structDelete(session, "user")>
        </cfif>
    </cffunction>
    
    <cffunction name="getUser" access="public" returntype="struct">
        <cfif isLoggedIn()>
            <cfreturn session.user>
        <cfelse>
            <cfreturn {username: "Guest"}>
        </cfif>
    </cffunction>
    
</cfcomponent>

<cfscript>
    auth = createObject("component", "UserAuth");
    
    // Handle login
    if (isDefined("form.username")) {
        loginResult = auth.login(form.username, form.password);
    }
    
    // Handle logout
    if (isDefined("url.logout")) {
        auth.logout();
    }
</cfscript>

<!DOCTYPE html>
<html>
<head>
    <title>User Authentication Demo</title>
    <style>
        body { font-family: Arial; max-width: 600px; margin: 50px auto; padding: 20px; }
        .success { background: ##e8f5e9; border: 2px solid ##4caf50; padding: 20px; margin: 20px 0; border-radius: 5px; }
        .error { background: ##ffebee; border: 2px solid ##f44336; padding: 20px; margin: 20px 0; border-radius: 5px; }
        .info { background: ##e3f2fd; border: 2px solid ##2196f3; padding: 20px; margin: 20px 0; border-radius: 5px; }
        input[type="text"], input[type="password"] { padding: 10px; width: 100%; margin: 10px 0; }
        button { padding: 12px 30px; background: ##4caf50; color: white; border: none; border-radius: 5px; cursor: pointer; }
        .logout-btn { background: ##f44336; }
    </style>
</head>
<body>

<h1>🔐 User Authentication Demo</h1>

<!--- Show login result --->
<cfif isDefined("loginResult")>
    <div class="<cfoutput>#loginResult.success ? 'success' : 'error'#</cfoutput>">
        <cfoutput>#loginResult.message#</cfoutput>
    </div>
</cfif>

<!--- Show current status --->
<div class="info">
    <h3>Current Status</h3>
    <cfif auth.isLoggedIn()>
        <cfset currentUser = auth.getUser()>
        <cfoutput>
            <p><strong>Status:</strong> ✓ Logged In</p>
            <p><strong>Username:</strong> #currentUser.username#</p>
            <p><strong>Login Time:</strong> #dateTimeFormat(currentUser.loginTime, "yyyy-mm-dd HH:nn:ss")#</p>
            <p><a href="?logout=true"><button class="logout-btn">Logout</button></a></p>
        </cfoutput>
    <cfelse>
        <p><strong>Status:</strong> ✗ Not Logged In</p>
    </cfif>
</div>

<!--- Show login form if not logged in --->
<cfif NOT auth.isLoggedIn()>
    <h2>Login Form</h2>
    <form method="post">
        <div>
            <label><strong>Username:</strong></label>
            <input type="text" name="username" value="admin" required>
            <small>Use: admin</small>
        </div>
        <div>
            <label><strong>Password:</strong></label>
            <input type="password" name="password" value="admin123" required>
            <small>Use: admin123</small>
        </div>
        <button type="submit">Login</button>
    </form>
</cfif>

<div style="margin-top: 30px; padding: 15px; background: ##f5f5f5; border-radius: 5px;">
    <h4>Component Methods:</h4>
    <ul>
        <li><strong>login(username, password)</strong> - Authenticate user</li>
        <li><strong>isLoggedIn()</strong> - Check if user is logged in</li>
        <li><strong>logout()</strong> - Log out current user</li>
        <li><strong>getUser()</strong> - Get current user info</li>
    </ul>
</div>

</body>
</html>

<cfcomponent output="false">
    <cfset this.name = "ValidationDemo">
</cfcomponent>

<cfcomponent>
    
    <cffunction name="validateEmail" access="public" returntype="boolean">
        <cfargument name="email" type="string" required="true">
        <cfreturn reFind("^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$", trim(arguments.email)) GT 0>
    </cffunction>
    
    <cffunction name="validatePhone" access="public" returntype="boolean">
        <cfargument name="phone" type="string" required="true">
        <cfset var cleanPhone = reReplace(arguments.phone, "[^0-9]", "", "ALL")>
        <cfreturn len(cleanPhone) EQ 10>
    </cffunction>
    
    <cffunction name="validateZipCode" access="public" returntype="boolean">
        <cfargument name="zipCode" type="string" required="true">
        <cfreturn reFind("^\d{5}(-\d{4})?$", trim(arguments.zipCode)) GT 0>
    </cffunction>
    
    <cffunction name="validateRequired" access="public" returntype="struct">
        <cfargument name="value" type="string" required="true">
        <cfargument name="fieldName" type="string" required="false" default="Field">
        
        <cfset var result = {valid: true, message: ""}>
        
        <cfif len(trim(arguments.value)) EQ 0>
            <cfset result.valid = false>
            <cfset result.message = "#arguments.fieldName# is required">
        </cfif>
        
        <cfreturn result>
    </cffunction>
    
    <cffunction name="validateLength" access="public" returntype="struct">
        <cfargument name="value" type="string" required="true">
        <cfargument name="minLength" type="numeric" required="true">
        <cfargument name="maxLength" type="numeric" required="true">
        
        <cfset var result = {valid: true, message: ""}>
        <cfset var valueLength = len(trim(arguments.value))>
        
        <cfif valueLength LT arguments.minLength>
            <cfset result.valid = false>
            <cfset result.message = "Must be at least #arguments.minLength# characters">
        <cfelseif valueLength GT arguments.maxLength>
            <cfset result.valid = false>
            <cfset result.message = "Cannot exceed #arguments.maxLength# characters">
        </cfif>
        
        <cfreturn result>
    </cffunction>
    
</cfcomponent>

<cfscript>
    validator = createObject("component", "Validator");
    
    // Test data
    testData = {
        validEmail: "john@example.com",
        invalidEmail: "not-an-email",
        validPhone: "(555) 123-4567",
        invalidPhone: "123",
        validZip: "12345",
        invalidZip: "ABC"
    };
</cfscript>

<!DOCTYPE html>
<html>
<head>
    <title>Data Validation Demo</title>
    <style>
        body { font-family: Arial; max-width: 800px; margin: 50px auto; padding: 20px; }
        table { width: 100%; border-collapse: collapse; margin: 20px 0; }
        th, td { padding: 12px; border: 1px solid ##ddd; text-align: left; }
        th { background: ##2196f3; color: white; }
        .valid { color: ##4caf50; font-weight: bold; }
        .invalid { color: ##f44336; font-weight: bold; }
        .info { background: ##e3f2fd; padding: 15px; margin: 20px 0; border-radius: 5px; }
    </style>
</head>
<body>

<h1>✅ Data Validation Demo</h1>

<h2>Email Validation</h2>
<table>
    <tr>
        <th>Email</th>
        <th>Valid?</th>
    </tr>
    <cfoutput>
        <tr>
            <td>#testData.validEmail#</td>
            <td class="#validator.validateEmail(testData.validEmail) ? 'valid' : 'invalid'#">
                #validator.validateEmail(testData.validEmail) ? '✓ Valid' : '✗ Invalid'#
            </td>
        </tr>
        <tr>
            <td>#testData.invalidEmail#</td>
            <td class="#validator.validateEmail(testData.invalidEmail) ? 'valid' : 'invalid'#">
                #validator.validateEmail(testData.invalidEmail) ? '✓ Valid' : '✗ Invalid'#
            </td>
        </tr>
    </cfoutput>
</table>

<h2>Phone Number Validation</h2>
<table>
    <tr>
        <th>Phone</th>
        <th>Valid?</th>
    </tr>
    <cfoutput>
        <tr>
            <td>#testData.validPhone#</td>
            <td class="#validator.validatePhone(testData.validPhone) ? 'valid' : 'invalid'#">
                #validator.validatePhone(testData.validPhone) ? '✓ Valid (10 digits)' : '✗ Invalid'#
            </td>
        </tr>
        <tr>
            <td>#testData.invalidPhone#</td>
            <td class="#validator.validatePhone(testData.invalidPhone) ? 'valid' : 'invalid'#">
                #validator.validatePhone(testData.invalidPhone) ? '✓ Valid' : '✗ Invalid (too short)'#
            </td>
        </tr>
    </cfoutput>
</table>

<h2>Zip Code Validation</h2>
<table>
    <tr>
        <th>Zip Code</th>
        <th>Valid?</th>
    </tr>
    <cfoutput>
        <tr>
            <td>#testData.validZip#</td>
            <td class="#validator.validateZipCode(testData.validZip) ? 'valid' : 'invalid'#">
                #validator.validateZipCode(testData.validZip) ? '✓ Valid' : '✗ Invalid'#
            </td>
        </tr>
        <tr>
            <td>#testData.invalidZip#</td>
            <td class="#validator.validateZipCode(testData.invalidZip) ? 'valid' : 'invalid'#">
                #validator.validateZipCode(testData.invalidZip) ? '✓ Valid' : '✗ Invalid'#
            </td>
        </tr>
    </cfoutput>
</table>

<h2>Advanced Validations</h2>

<cfset requiredCheck = validator.validateRequired("", "Username")>
<cfset lengthCheck = validator.validateLength("Hi", 5, 20)>

<div class="info">
    <h3>Required Field Check</h3>
    <cfoutput>
        <p><strong>Value:</strong> "" (empty)</p>
        <p><strong>Result:</strong> 
            <span class="#requiredCheck.valid ? 'valid' : 'invalid'#">
                #requiredCheck.valid ? '✓ Valid' : '✗ ' & requiredCheck.message#
            </span>
        </p>
    </cfoutput>
</div>

<div class="info">
    <h3>Length Validation</h3>
    <cfoutput>
        <p><strong>Value:</strong> "Hi" (must be 5-20 characters)</p>
        <p><strong>Result:</strong> 
            <span class="#lengthCheck.valid ? 'valid' : 'invalid'#">
                #lengthCheck.valid ? '✓ Valid' : '✗ ' & lengthCheck.message#
            </span>
        </p>
    </cfoutput>
</div>

</body>
</html>

<cfcomponent output="false">
    <cfset this.name = "ShoppingCartDemo">
    <cfset this.sessionManagement = true>
    <cfset this.sessionTimeout = createTimeSpan(0, 1, 0, 0)>
</cfcomponent>

<cfcomponent>
    
    <cffunction name="init" access="public" returntype="any">
        <cfif NOT structKeyExists(session, "cart")>
            <cfset session.cart = []>
        </cfif>
        <cfreturn this>
    </cffunction>
    
    <cffunction name="addItem" access="public" returntype="void">
        <cfargument name="productID" type="numeric" required="true">
        <cfargument name="productName" type="string" required="true">
        <cfargument name="price" type="numeric" required="true">
        
        <!--- Check if item exists --->
        <cfset var found = false>
        <cfloop array="#session.cart#" index="item">
            <cfif item.productID EQ arguments.productID>
                <cfset item.quantity = item.quantity + 1>
                <cfset found = true>
                <cfbreak>
            </cfif>
        </cfloop>
        
        <!--- Add new item if not found --->
        <cfif NOT found>
            <cfset arrayAppend(session.cart, {
                productID: arguments.productID,
                productName: arguments.productName,
                price: arguments.price,
                quantity: 1
            })>
        </cfif>
    </cffunction>
    
    <cffunction name="removeItem" access="public" returntype="void">
        <cfargument name="productID" type="numeric" required="true">
        
        <cfloop index="i" from="1" to="#arrayLen(session.cart)#">
            <cfif session.cart[i].productID EQ arguments.productID>
                <cfset arrayDeleteAt(session.cart, i)>
                <cfbreak>
            </cfif>
        </cfloop>
    </cffunction>
    
    <cffunction name="getItems" access="public" returntype="array">
        <cfreturn session.cart>
    </cffunction>
    
    <cffunction name="getTotal" access="public" returntype="numeric">
        <cfset var total = 0>
        <cfloop array="#session.cart#" index="item">
            <cfset total = total + (item.price * item.quantity)>
        </cfloop>
        <cfreturn total>
    </cffunction>
    
    <cffunction name="getItemCount" access="public" returntype="numeric">
        <cfset var count = 0>
        <cfloop array="#session.cart#" index="item">
            <cfset count = count + item.quantity>
        </cfloop>
        <cfreturn count>
    </cffunction>
    
    <cffunction name="clear" access="public" returntype="void">
        <cfset session.cart = []>
    </cffunction>
    
</cfcomponent>

<cfscript>
    cart = createObject("component", "Cart").init();
    
    // Handle add to cart
    if (isDefined("url.add")) {
        cart.addItem(url.productID, url.name, url.price);
    }
    
    // Handle remove from cart
    if (isDefined("url.remove")) {
        cart.removeItem(url.productID);
    }
    
    // Handle clear cart
    if (isDefined("url.clear")) {
        cart.clear();
    }
    
    // Sample products
    products = [
        {id: 1, name: "Laptop", price: 999.99},
        {id: 2, name: "Mouse", price: 29.99},
        {id: 3, name: "Keyboard", price: 79.99},
        {id: 4, name: "Monitor", price: 299.99}
    ];
</cfscript>

<!DOCTYPE html>
<html>
<head>
    <title>Shopping Cart Demo</title>
    <style>
        body { font-family: Arial; max-width: 900px; margin: 50px auto; padding: 20px; }
        .products { display: grid; grid-template-columns: repeat(2, 1fr); gap: 20px; margin: 20px 0; }
        .product { background: ##f5f5f5; padding: 20px; border-radius: 5px; }
        .price { font-size: 24px; color: ##4caf50; font-weight: bold; }
        .btn { padding: 10px 20px; background: ##4caf50; color: white; text-decoration: none; border-radius: 5px; display: inline-block; }
        .btn-remove { background: ##f44336; }
        .btn-clear { background: ##ff9800; }
        table { width: 100%; border-collapse: collapse; margin: 20px 0; }
        th, td { padding: 12px; border: 1px solid ##ddd; text-align: left; }
        th { background: ##2196f3; color: white; }
        .cart-summary { background: ##e3f2fd; padding: 20px; border-radius: 5px; margin: 20px 0; }
    </style>
</head>
<body>

<h1>🛒 Shopping Cart Demo</h1>

<h2>Products</h2>
<div class="products">
    <cfloop array="#products#" index="product">
        <cfoutput>
            <div class="product">
                <h3>#product.name#</h3>
                <p class="price">$#numberFormat(product.price, "0.00")#</p>
                <a href="?add=true&productID=#product.id#&name=#urlEncodedFormat(product.name)#&price=#product.price#" class="btn">
                    Add to Cart
                </a>
            </div>
        </cfoutput>
    </cfloop>
</div>

<h2>Your Cart</h2>

<cfset cartItems = cart.getItems()>

<cfif arrayLen(cartItems) GT 0>
    <table>
        <tr>
            <th>Product</th>
            <th>Price</th>
            <th>Quantity</th>
            <th>Subtotal</th>
            <th>Action</th>
        </tr>
        <cfloop array="#cartItems#" index="item">
            <cfoutput>
                <tr>
                    <td>#item.productName#</td>
                    <td>$#numberFormat(item.price, "0.00")#</td>
                    <td>#item.quantity#</td>
                    <td><strong>$#numberFormat(item.price * item.quantity, "0.00")#</strong></td>
                    <td><a href="?remove=true&productID=#item.productID#" class="btn btn-remove">Remove</a></td>
                </tr>
            </cfoutput>
        </cfloop>
    </table>
    
    <div class="cart-summary">
        <cfoutput>
            <h3>Cart Summary</h3>
            <p><strong>Total Items:</strong> #cart.getItemCount()#</p>
            <p><strong>Total Amount:</strong> <span style="font-size: 24px; color: ##4caf50;">$#numberFormat(cart.getTotal(), "0.00")#</span></p>
            <a href="?clear=true" class="btn btn-clear">Clear Cart</a>
        </cfoutput>
    </div>
<cfelse>
    <p style="padding: 20px; background: ##f5f5f5; border-radius: 5px;">Your cart is empty. Add some products above!</p>
</cfif>

</body>
</html>