001// Copyright 2004, 2005 The Apache Software Foundation 002// 003// Licensed under the Apache License, Version 2.0 (the "License"); 004// you may not use this file except in compliance with the License. 005// You may obtain a copy of the License at 006// 007// http://www.apache.org/licenses/LICENSE-2.0 008// 009// Unless required by applicable law or agreed to in writing, software 010// distributed under the License is distributed on an "AS IS" BASIS, 011// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 012// See the License for the specific language governing permissions and 013// limitations under the License. 014 015package org.apache.tapestry.link; 016 017import org.apache.tapestry.INamespace; 018import org.apache.tapestry.IRequestCycle; 019import org.apache.tapestry.engine.IEngineService; 020import org.apache.tapestry.engine.ILink; 021 022/** 023 * A component for creating a navigation link to another page, using the page service. [ <a 024 * href="../../../../../ComponentReference/PageLink.html">Component Reference </a>] 025 * 026 * @author Howard Ship 027 */ 028 029public abstract class PageLink extends AbstractLinkComponent 030{ 031 public abstract IEngineService getPageService(); 032 033 public ILink getLink(IRequestCycle cycle) 034 { 035 String parameter = null; 036 INamespace namespace = getTargetNamespace(); 037 String targetPage = getTargetPage(); 038 039 if (namespace == null) 040 parameter = targetPage; 041 else 042 parameter = namespace.constructQualifiedName(targetPage); 043 044 return getPageService().getLink(false, parameter); 045 } 046 047 public abstract String getTargetPage(); 048 049 /** @since 2.2 * */ 050 051 public abstract INamespace getTargetNamespace(); 052}