/* 
    P/P   *  Method: org.apache.roller.weblogger.ui.core.tags.calendar.CalendarModel__static_init
          */
     1  /*
     2   * Licensed to the Apache Software Foundation (ASF) under one or more
     3   *  contributor license agreements.  The ASF licenses this file to You
     4   * under the Apache License, Version 2.0 (the "License"); you may not
     5   * use this file except in compliance with the License.
     6   * You may obtain a copy of the License at
     7   *
     8   *     http://www.apache.org/licenses/LICENSE-2.0
     9   *
    10   * Unless required by applicable law or agreed to in writing, software
    11   * distributed under the License is distributed on an "AS IS" BASIS,
    12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13   * See the License for the specific language governing permissions and
    14   * limitations under the License.  For additional information regarding
    15   * copyright in this work, please see the NOTICE file in the top level
    16   * directory of this distribution.
    17   */
    18  
    19  package org.apache.roller.weblogger.ui.core.tags.calendar;
    20  import java.util.Calendar;
    21  import java.util.Date;
    22  
    23  /**
    24   * Model interface for the CalendarTag. The CalendarTag will set a day,
    25   * then use the computeUrl method to get the URLs it needs.
    26   */
    27  public interface CalendarModel {
    28      public Calendar getCalendar();
    29      
    30      public void setDay( String month ) throws Exception;
    31      
    32      public Date getDay();
    33      
    34      public Date getNextMonth();
    35  
    36      public Date getPrevMonth();
    37      
    38      public String computePrevMonthUrl();
    39      
    40      public String computeTodayMonthUrl();
    41      
    42      public String computeNextMonthUrl();
    43  
    44      /**
    45       * Get the earliest month in which there could possibly be data.  For a weblog this
    46       * is the beginning of the month containing the creation date.
    47       */
    48      //public Date getInitialMonth();
    49      
    50      /**
    51       * Create URL for use on edit-weblog page, preserves the request
    52       * parameters used by the tabbed-menu tag for navigation.
    53       *
    54       * @param day      Day for URL
    55       * @param monthURL True to return month URL (6-char date)
    56       * @param valid    Always return a URL, never return null
    57       * @return         URL for day, or null if no weblog entry on that day
    58       */
    59      public String computeUrl( java.util.Date day, boolean monthURL, boolean valid );
    60      
    61      /**
    62       * Get calendar cell content or null if none.
    63       *
    64       * @param day Day for URL
    65       * @param valid Always return a URL, never return null
    66       * @return Calendar cell content or null if none.
    67       */
    68      public String getContent( java.util.Date day );
    69  }
    70