| /* |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| */ |
| package org.apache.wiki.xmlrpc; |
| |
| import org.apache.wiki.WikiContext; |
| import org.apache.wiki.WikiEngine; |
| import org.apache.wiki.WikiPage; |
| import org.apache.wiki.auth.AuthorizationManager; |
| import org.apache.wiki.auth.permissions.PagePermission; |
| import org.apache.wiki.auth.permissions.WikiPermission; |
| import org.apache.xmlrpc.AuthenticationFailed; |
| |
| import java.security.Permission; |
| import java.util.Calendar; |
| import java.util.Date; |
| import java.util.Hashtable; |
| import java.util.Set; |
| import java.util.Vector; |
| |
| /** |
| * Provides definitions for RPC handler routines. |
| * |
| * @since 1.6.13 |
| */ |
| |
| public abstract class AbstractRPCHandler implements WikiRPCHandler { |
| |
| /** Error code: no such page. */ |
| public static final int ERR_NOPAGE = 1; |
| public static final int ERR_NOPERMISSION = 2; |
| |
| /** Link to a local wiki page. */ |
| public static final String LINK_LOCAL = "local"; |
| |
| /** Link to an external resource. */ |
| public static final String LINK_EXTERNAL = "external"; |
| |
| /** This is an inlined image. */ |
| public static final String LINK_INLINE = "inline"; |
| |
| protected WikiEngine m_engine; |
| protected WikiContext m_context; |
| |
| /** This is the currently implemented JSPWiki XML-RPC code revision. */ |
| public static final int RPC_VERSION = 1; |
| |
| public void initialize( final WikiContext context ) { |
| m_context = context; |
| m_engine = context.getEngine(); |
| } |
| |
| protected abstract Hashtable encodeWikiPage( WikiPage p ); |
| |
| public Vector getRecentChanges( final Date since ) { |
| checkPermission( PagePermission.VIEW ); |
| final Set< WikiPage > pages = m_engine.getPageManager().getRecentChanges(); |
| final Vector< Hashtable< ?, ? > > result = new Vector<>(); |
| |
| // Transform UTC into local time. |
| final Calendar cal = Calendar.getInstance(); |
| cal.setTime( since ); |
| cal.add( Calendar.MILLISECOND, cal.get( Calendar.ZONE_OFFSET ) + |
| (cal.getTimeZone().inDaylightTime( since ) ? cal.get( Calendar.DST_OFFSET ) : 0 ) ); |
| |
| for( WikiPage page : pages ) { |
| if( page.getLastModified().after( cal.getTime() ) ) { |
| result.add( encodeWikiPage( page ) ); |
| } |
| } |
| |
| return result; |
| } |
| |
| /** |
| * Checks whether the current user has permission to perform the RPC action; |
| * throws an exception if not allowed by {@link org.apache.wiki.auth.AuthorizationManager}. |
| * |
| * @param perm the Permission to check |
| */ |
| protected void checkPermission( final Permission perm ) { |
| final AuthorizationManager mgr = m_engine.getAuthorizationManager(); |
| |
| if( mgr.checkPermission( m_context.getWikiSession(), perm ) ) { |
| return; |
| } |
| |
| throw new AuthenticationFailed( "You have no access to this resource, o master" ); |
| } |
| |
| /** |
| * Returns the current supported JSPWiki XML-RPC API. |
| */ |
| public int getRPCVersionSupported() { |
| checkPermission( WikiPermission.LOGIN ); |
| return RPC_VERSION; |
| } |
| |
| } |