/
ContentHandler.java
98 lines (88 loc) · 3.21 KB
/
ContentHandler.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/**
* Copyright (c) 2012, Ben Fortuna
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* o Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* o Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* o Neither the name of Ben Fortuna nor the names of any other contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
package net.fortuna.ical4j.data;
import java.io.IOException;
import java.net.URISyntaxException;
/**
* <pre>
* $Id$ [Nov 5,
* 2004]
* </pre>
*
* Implementors provide functionality applicable during the parsing of an iCalendar data stream (e.g. building an object
* model).
* @author Ben Fortuna
*/
public interface ContentHandler {
/**
* Triggers the start of handling a calendar.
*/
void startCalendar();
/**
* Triggers the end of handling a calendar.
*/
void endCalendar() throws IOException;
/**
* Triggers the start of handling a component.
* @param name a component name
*/
void startComponent(String name);
/**
* Triggers the end of handling a component.
* @param name a component name
*/
void endComponent(String name);
/**
* Triggers the start of handling a property.
* @param name a property name
*/
void startProperty(String name);
/**
* Triggers the handling of a property value.
* @param value a property value
* @throws URISyntaxException where the property value is not a valid URI for applicable properties
* @throws IOException where data cannot be read for applicable properties
*/
void propertyValue(String value);
/**
* Triggers the end of handling a property.
* @param name a property name
*/
void endProperty(String name);
/**
* Triggers the handling of a parameter.
* @param name a parameter name
* @param value a parameter value
* @throws IllegalArgumentException where the parameter value is not a valid URI for applicable parameters
*/
void parameter(String name, String value);
}